EDI Transactions (Stedi-Compatible)

Poll Transactions

Stedi Core-compatible Poll Transactions. Returns transactions in ascending processing order so an incremental consumer can follow the stream without gaps.

Supply either startDateTime (initial poll) or pageToken (subsequent polls) — at least one is required. Unlike the list endpoint, polling always returns a nextPageToken, including on an empty page: when no new transactions are ready, the token re-encodes your current position rather than advancing the cursor, so no transaction can be skipped by a concurrent webhook or a delayed retry. Persist the token and pass it back on the next poll.

GET

api

stedi

2023-08-01

polling

transactions

Poll transactions

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

import requests

url = "https://forecaster.cairhealth.com/api/stedi/2023-08-01/polling/transactions"

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/polling/transactions', 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/polling/transactions",
  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/polling/transactions"

	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/polling/transactions")

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

{
  "items": [
    {
      "transactionId": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
      "fileExecutionId": "ffeeddccbbaa99887766554433221100",
      "status": "succeeded",
      "direction": "OUTBOUND",
      "mode": "production",
      "processedAt": "2026-10-05T15:00:00.000Z",
      "artifacts": [
        {
          "artifactType": "application/edi-x12",
          "usage": "input",
          "sizeBytes": 4096,
          "url": "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/a1b2c3d4e5f60718293a4b5c6d7e8f90/input",
          "model": "transaction"
        }
      ],
      "partnership": {
        "partnershipId": "local-clearinghouse",
        "partnershipType": "x12",
        "sender": {
          "profileId": "local"
        },
        "receiver": {
          "profileId": "clearinghouse"
        }
      },
      "x12": {
        "metadata": {
          "interchange": {
            "acknowledgmentRequestedCode": "0",
            "controlNumber": 43
          },
          "functionalGroup": {
            "controlNumber": 2,
            "release": "005010X222A1",
            "date": "2026-10-05",
            "time": "15:00:00",
            "functionalIdentifierCode": "HC"
          },
          "transaction": {
            "controlNumber": "0001",
            "transactionSetIdentifier": "837"
          },
          "sender": {
            "applicationCode": "ZZ",
            "isa": {
              "qualifier": "ZZ",
              "id": "SUBMITTER"
            }
          },
          "receiver": {
            "applicationCode": "ZZ",
            "isa": {
              "qualifier": "ZZ",
              "id": "RECEIVER"
            }
          }
        }
      }
    }
  ],
  "nextPageToken": "1f2e3d4c5b6a79880716253443526170"
}

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

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

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

Overview

Returns transactions in ascending processing order so an incremental consumer can follow the stream without missing anything. This is a 1:1 drop-in for Stedi’s Poll Transactions operation. Use polling when you want to mirror every transaction into your own system: keep the returned nextPageToken, wait, then call again with that token. Use List Transactions when you want to search or browse history.

Authentication

JWT Bearer token from POST /api/token, with the api-access feature.

Query parameters

string

ISO 8601 date-time for the initial poll, e.g. 2026-10-01T00:00:00Z. Only transactions processed after this time are returned. Required on the first call when you do not yet have a pageToken.

string

Cursor from the previous poll’s nextPageToken. Pass this on every poll after the first. If both pageToken and startDateTime are supplied, the token takes precedence.

integer

default:"100"

Maximum transactions per poll, 1–500. Defaults to 100.

You must supply at least one of pageToken or startDateTime; otherwise the request returns 400 BadRequestException.

Example

First poll, then continue with the returned cursor:

# Initial poll
curl "https://forecaster.cairhealth.com/api/stedi/2023-08-01/polling/transactions?startDateTime=2026-10-01T00:00:00Z" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

# Subsequent poll — reuse nextPageToken from the previous response
curl "https://forecaster.cairhealth.com/api/stedi/2023-08-01/polling/transactions?pageToken=$NEXT_PAGE_TOKEN" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

A polling loop:

async function poll(cursor?: string) {
  const url = new URL(
    'https://forecaster.cairhealth.com/api/stedi/2023-08-01/polling/transactions',
  );
  if (cursor) {
    url.searchParams.set('pageToken', cursor);
  } else {
    url.searchParams.set('startDateTime', new Date().toISOString());
  }

  const response = await fetch(url, {
    headers: { Authorization: `Bearer ${process.env.CAIR_ACCESS_TOKEN}` },
  });
  const page = await response.json();

  for (const transaction of page.items) {
    await handleTransaction(transaction);
  }

  // Always persist this token, even when items is empty.
  return page.nextPageToken as string;
}

Response

{
  "items": [
    {
      "transactionId": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
      "fileExecutionId": "ffeeddccbbaa99887766554433221100",
      "status": "succeeded",
      "direction": "OUTBOUND",
      "mode": "production",
      "processedAt": "2026-10-05T15:00:00.000Z",
      "artifacts": [
        {
          "artifactType": "application/edi-x12",
          "usage": "input",
          "sizeBytes": 4096,
          "url": "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/a1b2c3d4e5f60718293a4b5c6d7e8f90/input",
          "model": "transaction"
        }
      ],
      "partnership": {
        "partnershipId": "local-clearinghouse",
        "partnershipType": "x12",
        "sender": { "profileId": "local" },
        "receiver": { "profileId": "clearinghouse" }
      },
      "x12": {
        "metadata": {
          "interchange": { "acknowledgmentRequestedCode": "0", "controlNumber": 43 },
          "functionalGroup": {
            "controlNumber": 2,
            "release": "005010X222A1",
            "date": "2026-10-05",
            "time": "15:00:00",
            "functionalIdentifierCode": "HC"
          },
          "transaction": { "controlNumber": "0001", "transactionSetIdentifier": "837" },
          "sender": { "applicationCode": "ZZ", "isa": { "qualifier": "ZZ", "id": "SUBMITTER" } },
          "receiver": { "applicationCode": "ZZ", "isa": { "qualifier": "ZZ", "id": "RECEIVER" } }
        }
      }
    }
  ],
  "nextPageToken": "1f2e3d4c5b6a79880716253443526170"
}

Cursor semantics

Unlike the list endpoint, polling always returns a nextPageToken, including when items is empty.

On a full or partial page, the token points at the last returned transaction. Call again immediately to continue.
On an empty page, the token re-encodes your current position rather than jumping to the present. This guarantees zero gaps: a webhook that arrives slightly out of order, or an uploaded X12 with a historical processedAt, is still delivered on a later poll.
Never discard the token on an empty page — that is how the stream advances.

There is a short maturity delay of a few seconds before a transaction becomes pollable, so an in-flight insert cannot be observed half-written. A transaction may therefore appear a few seconds after it is created.

Stop condition

Polling is a never-ending stream by design; decide your own cadence (for example every 30 seconds) and stop when your process exits. Reuse the same cursor across restarts so you do not miss or duplicate the boundary transaction.

Authorizations

Authorization

string

header

required

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

Query Parameters

pageSize

integer

default:100

Maximum number of transactions to return in a page (1–500). Defaults to 100.

Required range: 1 <= x <= 500

pageToken

string

Cursor returned as nextPageToken by the previous poll. Pass this on every poll after the first. Mutually exclusive with startDateTime (the token wins).

startDateTime

string<date-time>

ISO 8601 date-time for the initial poll, e.g. 2026-10-01T00:00:00Z. Only transactions after this time are returned. Required on the first poll when no pageToken is available.

Response

A page of new transactions. nextPageToken is always present.

items

object[]

required

Show child attributes

nextPageToken

string

required

Always present. Pass it back on the next poll. On an empty page it encodes your current position so no transactions are skipped.

Poll transactions

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

import requests

url = "https://forecaster.cairhealth.com/api/stedi/2023-08-01/polling/transactions"

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/polling/transactions', 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/polling/transactions",
  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/polling/transactions"

	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/polling/transactions")

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

{
  "items": [
    {
      "transactionId": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
      "fileExecutionId": "ffeeddccbbaa99887766554433221100",
      "status": "succeeded",
      "direction": "OUTBOUND",
      "mode": "production",
      "processedAt": "2026-10-05T15:00:00.000Z",
      "artifacts": [
        {
          "artifactType": "application/edi-x12",
          "usage": "input",
          "sizeBytes": 4096,
          "url": "https://forecaster.cairhealth.com/api/stedi/2023-08-01/transactions/a1b2c3d4e5f60718293a4b5c6d7e8f90/input",
          "model": "transaction"
        }
      ],
      "partnership": {
        "partnershipId": "local-clearinghouse",
        "partnershipType": "x12",
        "sender": {
          "profileId": "local"
        },
        "receiver": {
          "profileId": "clearinghouse"
        }
      },
      "x12": {
        "metadata": {
          "interchange": {
            "acknowledgmentRequestedCode": "0",
            "controlNumber": 43
          },
          "functionalGroup": {
            "controlNumber": 2,
            "release": "005010X222A1",
            "date": "2026-10-05",
            "time": "15:00:00",
            "functionalIdentifierCode": "HC"
          },
          "transaction": {
            "controlNumber": "0001",
            "transactionSetIdentifier": "837"
          },
          "sender": {
            "applicationCode": "ZZ",
            "isa": {
              "qualifier": "ZZ",
              "id": "SUBMITTER"
            }
          },
          "receiver": {
            "applicationCode": "ZZ",
            "isa": {
              "qualifier": "ZZ",
              "id": "RECEIVER"
            }
          }
        }
      }
    }
  ],
  "nextPageToken": "1f2e3d4c5b6a79880716253443526170"
}

{
  "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

Poll Transactions

Overview

Authentication

Query parameters

Example

Response

Cursor semantics

Stop condition

Authorizations

Query Parameters

Response

​Overview

​Authentication

​Query parameters

​Example

​Response

​Cursor semantics

​Stop condition

Authorizations

Query Parameters

Response

Overview

Authentication

Query parameters

Example

Response

Cursor semantics

Stop condition