Introducing the Claims Lifecycle API, Stedi's headless RCM engine

You can now use Stedi's Claims Lifecycle API endpoints to retrieve the same claim records that power the claims view in the Stedi portal. The endpoints return the claim's status, submission date, charge amounts, paid amounts, and full history, providing a powerful headless RCM engine that can drive external applications.

Endpoint	What it does
List Claims	Returns a paginated list of claim records, newest first. Filter by status, patient control number, or submission time.
Retrieve Claim	Returns a single claim record for a claim ID.
Retrieve Claim Timeline	Returns a claim's full history: submissions, 277CA claim acknowledgments, and claim payment information from Electronic Remittance Advice (ERAs).

Previously, the Stedi portal's claims view was the only place to see a claim's full lifecycle. Through the API, you received each response on its own – a 277CA claim acknowledgment here, an ERA there. You had to match each response back to the original claim, usually on the patient control number (PCN).

Now Stedi does the matching and returns the result. The new endpoints serve the same claim data that powers the claims view, so your dashboard can show what the portal shows.

Watch the 2026 Stedi Keynote announcement:

Claim records

A claim record holds summary information about a claim, including its current status. A Retrieve Claim API response contains a single claim record:

{
  "id": "clm_01K6XFP3TZ8RA9X84963NMW40N",  // Stedi's claim ID
  "patientControlNumber": "123456",
  "patientName": { "firstName": "John", "lastName": "Doe" },
  "type": "PROFESSIONAL",
  "stediPayerId": "ABCDE",
  "datesOfService": { "start": "2026-01-05" },
  "submittedAt": "2026-01-16T10:00:00Z",  // Time Stedi processed the most recent submission
  "status": "PROCESSED",
  "statusReportedBy": "PAYER", // PAYER or CLEARINGHOUSE
  "totalClaimChargeAmount": "832.00",
  "totalClaimPaidAmount": "200.00" // Sum of payments matched to the claim from ERAs. Includes reversals (negative amounts)
}

The claim record's status field uses the same claim processing statuses as the portal: SUBMITTED, RECEIVED, ACCEPTED, REJECTED, PROCESSED, DENIED, and UNKNOWN.

Claim IDs

Each claim record includes a claim ID. The ID stays the same for the life of the claim. A resubmission updates the record, but doesn't change the claim ID. One claim ID tracks the claim across every submission.

Filters and pagination

You can use the List Claims API endpoint to filter a list of claim records by status, patientControlNumbers (up to 20), and a submittedAfter/submittedBefore time range.

For example, this request returns denied claims submitted since January 1:

curl --request GET \
  --url "https://claims.us.stedi.com/2025-03-07/claims?status=DENIED&submittedAfter=2026-01-01T00:00:00Z" \
  --header 'Authorization: <api-key>'

You can page through responses using token-based pagination. Responses include a nextPageToken when more results are available. The pageSize parameter defaults to 100 claim records, up to a maximum of 500.

Claim timeline

The Retrieve Claim Timeline API endpoint returns one entry per event in the claim's history, newest first. Each entry holds exactly one property, and the property name tells you the entry type:

professionalClaimSubmission, institutionalClaimSubmission, or dentalClaimSubmission – A submission or resubmission.
claimAcknowledgment – A 277CA claim acknowledgment from Stedi or the payer.
claimPaymentInformation – A claim payment information record from an ERA.

A resubmitted claim carries every attempt on one timeline, along with the acknowledgments and payments tied to each attempt.

SDK support

The Stedi TypeScript and Python SDKs include operations that cover the three Claims Lifecycle API endpoints.

Availability and pricing

The Claims Lifecycle API endpoints are available on all Stedi production accounts. Claim retrieval is free.

For more details, see our announcement blog.