Retrieve Claim Timeline

Retrieve a paginated list of a claim's timeline entries, newest first. Timeline entries include submissions, acknowledgments, and claim payment information

GET /claims/{id}/timeline

Retrieve a paginated history of a claim's timeline entries including submissions, 277CA claim acknowledgments, and claim payment information from Electronic Remittance Advice (ERAs).

Use this endpoint when you need to view the complete lifecycle of a claim.

1. Call this endpoint with the claim ID. You can retrieve this ID from:

   • The claimId property in the Create Professional Claim JSON endpoint response. Other claim submission endpoints don't return this property.
   • The items.id property in the List Claims endpoint response.
   • A claim's details page in the claims view.

2. Stedi returns a paginated list of timeline entries, ordered by most recent first.

Authorizations

Authorization · Required Header

A production Stedi API Key for authentication.

Path Parameters

id · String Regex pattern : ^(clm_)?[0-7][0-9A-HJKMNP-TV-Z]{25}$

A unique identifier for the claim within Stedi. You can retrieve this ID from the claimId property in a claim submission response or from the list claims endpoint.

Query Parameters

pageSize · Number Range : ≥ 1 and ≤ 500

The maximum number of timeline entries to return per page. Defaults to 100.

pageToken · String Length : 1 - 1024

The nextPageToken from a previous call to this operation. If not specified, Stedi returns the first page of results.

Response

application/json

items · Array of Items Required

Timeline entries for the claim, newest first, including submissions, acknowledgments, and claim payment information.

professionalClaimSubmission · items[].professionalClaimSubmission · Object Required

An 837P professional claim submission, either the initial submission or a resubmission.

datesOfService · items[].professionalClaimSubmission.datesOfService · Object

The dates of service from the claim. A single date of service carries only start. Absent when the submitted dates aren't valid calendar dates.

end · items[].professionalClaimSubmission.datesOfService.end · String Regex pattern : ^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$

The end date of the range, inclusive, in YYYY-MM-DD format.

start · items[].professionalClaimSubmission.datesOfService.start · String Required Regex pattern : ^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$

The start date of the range, in YYYY-MM-DD format.

id · items[].professionalClaimSubmission.id · String Required Max length : 40

A unique identifier for a specific submission of a claim within Stedi. Stedi generates a submission ID for the initial submission and then a new submission ID for every resubmission of the same claim. This is different from the claim ID, which doesn't change throughout the claim's lifecycle.

patientControlNumber · items[].professionalClaimSubmission.patientControlNumber · String Required Length : 1 - 38

The patient control number you assigned to the claim.

patientName · items[].professionalClaimSubmission.patientName · Object

The name of the patient who received the services on the claim.

firstName · items[].professionalClaimSubmission.patientName.firstName · String

The patient's first name.

lastName · items[].professionalClaimSubmission.patientName.lastName · String

The patient's last name.

middleName · items[].professionalClaimSubmission.patientName.middleName · String

The patient's middle name.

suffix · items[].professionalClaimSubmission.patientName.suffix · String

The patient's name suffix.

processedAt · items[].professionalClaimSubmission.processedAt · String Required Format : date-time

The time Stedi processed the submission.

stediPayerId · items[].professionalClaimSubmission.stediPayerId · String Regex pattern : ^[A-Z]{5}$

The payer identifier in Stedi's system. This is the Stedi payer ID listed in the Stedi Payer Network.

totalClaimChargeAmount · items[].professionalClaimSubmission.totalClaimChargeAmount · String Required Regex pattern : ^-?\d+\.\d{2}$

The total charge amount of the submitted claim.

nextPageToken · String Length : 1 - 1024

Token you can supply in subsequent requests to retrieve the next page of results. If absent, there are no more results.

Request

curl --request GET \
  --url "https://claims.us.stedi.com/2025-03-07/claims/{id}/timeline?pageSize=100" \
  --header "Authorization: <api_key>"

Response

{
  "items": [
    {
      "claimPaymentInformation": {
        "checkOrEftTraceNumber": "TRN123456789",
        "claimPaymentAmount": "200.00",
        "id": "clp_01K6XFP3TZ8RA9X84963NMW43R",
        "patientResponsibilityAmount": "50.00",
        "processedAt": "2026-01-16T10:00:00Z",
        "statusCode": "PROCESSED_AS_PRIMARY",
        "totalClaimChargeAmount": "250.00"
      }
    },
    {
      "claimAcknowledgment": {
        "id": "ack_01K6XFP3TZ8RA9X84963NMW42Q",
        "processedAt": "2026-01-08T09:30:00Z",
        "reportedBy": "PAYER",
        "sourceName": "ACME INSURANCE",
        "status": "ACCEPTED"
      }
    },
    {
      "professionalClaimSubmission": {
        "datesOfService": {
          "start": "2026-01-05"
        },
        "id": "sbm_01K6XFP3TZ8RA9X84963NMW41P",
        "patientControlNumber": "123456",
        "patientName": {
          "firstName": "John",
          "lastName": "Doe",
          "middleName": "Michael",
          "suffix": "Jr"
        },
        "processedAt": "2026-01-07T15:12:45Z",
        "stediPayerId": "ABCDE",
        "totalClaimChargeAmount": "250.00"
      }
    }
  ],
  "nextPageToken": "eyJsYXN0SWQiOiIwMUs2WEZQMyJ9"
}