EDI Transactions (Stedi-Compatible)

Get Transaction Input

Stedi Core-compatible Retrieve Transaction Input — the raw artifact Cair originally received (typically the X12 EDI).

An authenticated call returns a 302 Found whose Location header and documentDownloadUrl body point at a short-lived, presigned download URL. Follow that URL (with or without the Authorization header) to stream the artifact bytes; the presigned URL is valid for 60 minutes and is bound to your organization, the transaction, and the input usage. This two-step flow matches Stedi’s document-download endpoints so existing Stedi SDKs work unchanged.

GET

api

stedi

2023-08-01

transactions

{transactionId}

input

Get a transaction's input document

curl --request GET \
  --url https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

"<string>"

{
  "documentDownloadUrl": "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/c1f2e3d4a5b6c7d8e9f0a1b2c3d4e5f6/input?token=6f1e2d3c4b5a69788796a5b4c3d2e1f0"
}

{
  "message": "<string>",
  "code": "BadRequestException"
}

{
  "message": "<string>",
  "code": "BadRequestException"
}

{
  "message": "<string>",
  "code": "BadRequestException"
}

Overview

Downloads the transaction’s input document — the raw artifact Cair originally received, which is the X12 EDI file for stedi, upload, and eob-conversion transactions. This is a 1:1 drop-in for Stedi’s Retrieve Transaction Input operation and the Stedi SDK’s getTransactionInput.

Authentication

The initial request is authenticated with your JWT Bearer token from POST /api/token, with the api-access feature. The download request that follows the redirect is authenticated by the presigned token in the URL and does not require the Authorization header.

Path parameters

string

required

The transactionId whose input artifact you want to download.

Two-step download flow

Media downloads on Stedi are a redirect to a short-lived, presigned URL, and Cair reproduces that exactly:

Authenticated request. Call the endpoint with your Bearer token. Cair responds 302 Found with:
- Location header pointing at a presigned URL.
- Body { "documentDownloadUrl": "<presigned URL>" }.
Follow the redirect. Fetch the presigned URL — with or without the Authorization header — and Cair streams the raw artifact bytes with a Content-Type matching the artifact (for input documents this is usually application/edi-x12).

Most HTTP clients follow the 302 automatically, so a Stedi SDK or a fetch with the default redirect: 'follow' gets the bytes in one call. The presigned URL is valid for 60 minutes and is bound to your organization, the transaction, and the input usage, so it cannot be replayed for another transaction or artifact kind.

The presigned URL is https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input?token=.... Requests to it do not need (and ignore) the Authorization header; the token query parameter is what authorizes the download.

Example

Follow the redirect automatically with curl -L:

curl -L "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/c1f2e3d4a5b6c7d8e9f0a1b2c3d4e5f6/input" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -o transaction.x12

Handle the two steps explicitly:

const initial = await fetch(
  `https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/${transactionId}/input`,
  {
    headers: { Authorization: `Bearer ${process.env.CAIR_ACCESS_TOKEN}` },
    redirect: 'manual',
  },
);

// 302 Found — read the presigned URL from the body (or the Location header)
const { documentDownloadUrl } = await initial.json();

// No Authorization header needed here
const artifact = await fetch(documentDownloadUrl);
const x12 = await artifact.text();

With the Stedi SDK, getTransactionInput follows the redirect for you and returns the bytes:

const x12 = await stedi.core.getTransactionInput('c1f2e3d4a5b6c7d8e9f0a1b2c3d4e5f6');

Response

302 Found — body:

{
  "documentDownloadUrl": "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/c1f2e3d4a5b6c7d8e9f0a1b2c3d4e5f6/input?token=6f1e2d3c4b5a69788796a5b4c3d2e1f0"
}

200 OK (after following the redirect) — the raw artifact, e.g.:

ISA*00*          *00*          *ZZ*SUBMITTER      *ZZ*RECEIVER       *261005*1412*^*00501*000000042*0*P*:~
GS*HP*SUBMITTER*RECEIVER*20261005*1412*1*X*005010X221A1~
...

Errors

Status	Meaning
`401`	Missing/invalid Bearer token on the initial call, or an invalid/expired presigned token.
`404`	Transaction or input artifact not found, or not owned by your organization.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

transactionId

string

required

Unique identifier of the processed transaction (the transactionId returned by the list/poll endpoints).

Response

Raw input artifact bytes, returned when the presigned URL is followed. Content-Type matches the artifact (e.g. application/edi-x12).

The response is of type file.

Get a transaction's input document

curl --request GET \
  --url https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/{transactionId}/input")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

"<string>"

{
  "documentDownloadUrl": "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/c1f2e3d4a5b6c7d8e9f0a1b2c3d4e5f6/input?token=6f1e2d3c4b5a69788796a5b4c3d2e1f0"
}

{
  "message": "<string>",
  "code": "BadRequestException"
}

{
  "message": "<string>",
  "code": "BadRequestException"
}

{
  "message": "<string>",
  "code": "BadRequestException"
}

Overview

API Authentication

Eligibility

Enrollments/Providers

Claims

EDI Transactions (Stedi-Compatible)

Claim AI Actions

Patient Chart Analysis

Patient Payments

Patients

Webhooks

AI Phone Calls

Get Transaction Input

Overview

Authentication

Path parameters

Two-step download flow

Example

Response

Errors

Authorizations

Path Parameters

Response

​Overview

​Authentication

​Path parameters

​Two-step download flow

​Example

​Response

​Errors

Authorizations

Path Parameters

Response

Overview

Authentication

Path parameters

Two-step download flow

Example

Response

Errors