---
title: "GET /claims/{id}/timeline"
method: GET
path: "/claims/{id}/timeline"
---

# GET /claims/{id}/timeline

`GET /claims/{id}/timeline`

## Request

- Base URL: `https://claims.us.stedi.com/2025-03-07`
- URL: `https://claims.us.stedi.com/2025-03-07/claims/{id}/timeline`
- Auth: API key in header `Authorization`

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

## Path parameters

- `id` string, required: 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: The maximum number of timeline entries to return per page. Defaults to 100.
- `pageToken` string: The `nextPageToken` from a previous call to this operation. If not specified, Stedi returns the first page of results.

## Response `200`

GetClaimTimeline 200 response

- GetClaimTimelineResponseContent: A page of a claim's timeline.
  - `items` ClaimTimelineEvent[], required: Timeline entries for the claim, newest first, including submissions, acknowledgments, and claim payment information.
    - union: A timeline entry in a claim's history. Exactly one property is set, and its name identifies the type of entry.
      - object
        - `professionalClaimSubmission` ClaimSubmissionSummary, required: A summary of a claim submission.
          - `datesOfService` ClaimDateRange: A date range. `end` is inclusive. A single date of service carries only `start`.
            - `end` string: The end date of the range, inclusive, in `YYYY-MM-DD` format.
            - `start` string, required: The start date of the range, in `YYYY-MM-DD` format.
          - `id` string, required: 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` string, required: The patient control number you assigned to the claim.
          - `patientName` ClaimPatientName: The name of the patient who received the services on the claim.
            - `firstName` string: The patient's first name.
            - `lastName` string: The patient's last name.
            - `middleName` string: The patient's middle name.
            - `suffix` string: The patient's name suffix.
          - `processedAt` string, date-time, required: The time Stedi processed the submission.
          - `stediPayerId` string: The payer identifier in Stedi's system. This is the Stedi payer ID listed in the Stedi [Payer Network](https://www.stedi.com/healthcare/network).
          - `totalClaimChargeAmount` string, required: The total charge amount of the submitted claim.
      - object
        - `dentalClaimSubmission` ClaimSubmissionSummary, required: A summary of a claim submission.
          - `datesOfService` ClaimDateRange: A date range. `end` is inclusive. A single date of service carries only `start`.
            - `end` string: The end date of the range, inclusive, in `YYYY-MM-DD` format.
            - `start` string, required: The start date of the range, in `YYYY-MM-DD` format.
          - `id` string, required: 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` string, required: The patient control number you assigned to the claim.
          - `patientName` ClaimPatientName: The name of the patient who received the services on the claim.
            - `firstName` string: The patient's first name.
            - `lastName` string: The patient's last name.
            - `middleName` string: The patient's middle name.
            - `suffix` string: The patient's name suffix.
          - `processedAt` string, date-time, required: The time Stedi processed the submission.
          - `stediPayerId` string: The payer identifier in Stedi's system. This is the Stedi payer ID listed in the Stedi [Payer Network](https://www.stedi.com/healthcare/network).
          - `totalClaimChargeAmount` string, required: The total charge amount of the submitted claim.
      - object
        - `institutionalClaimSubmission` ClaimSubmissionSummary, required: A summary of a claim submission.
          - `datesOfService` ClaimDateRange: A date range. `end` is inclusive. A single date of service carries only `start`.
            - `end` string: The end date of the range, inclusive, in `YYYY-MM-DD` format.
            - `start` string, required: The start date of the range, in `YYYY-MM-DD` format.
          - `id` string, required: 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` string, required: The patient control number you assigned to the claim.
          - `patientName` ClaimPatientName: The name of the patient who received the services on the claim.
            - `firstName` string: The patient's first name.
            - `lastName` string: The patient's last name.
            - `middleName` string: The patient's middle name.
            - `suffix` string: The patient's name suffix.
          - `processedAt` string, date-time, required: The time Stedi processed the submission.
          - `stediPayerId` string: The payer identifier in Stedi's system. This is the Stedi payer ID listed in the Stedi [Payer Network](https://www.stedi.com/healthcare/network).
          - `totalClaimChargeAmount` string, required: The total charge amount of the submitted claim.
      - object
        - `claimAcknowledgment` ClaimAcknowledgmentSummary, required: A summary of a 277CA claim acknowledgment from a clearinghouse or the payer.
          - `id` string, required: A unique identifier for the acknowledgment within Stedi.
          - `processedAt` string, date-time, required: The time Stedi processed the acknowledgment.
          - `reportedBy` 'PAYER' | 'CLEARINGHOUSE', required: The entity that reported a claim status. - `PAYER`: The payer reported the status, in a 277CA claim acknowledgment or an 835 ERA. - `CLEARINGHOUSE`: A clearinghouse reported the status, either Stedi or an intermediary clearinghouse between Stedi and the payer.
          - `sourceName` string, required: The name of the clearinghouse or payer that reported the status, as it appears in the 277CA.
          - `status` 'REJECTED' | 'ACCEPTED' | 'RECEIVED' | 'INVALID', required: The status a clearinghouse or the payer reported for the claim in a 277CA claim acknowledgment. - `REJECTED`: A clearinghouse or the payer rejected the claim. The payer won't adjudicate the claim until you correct and resubmit it. - `ACCEPTED`: A clearinghouse or the payer accepted the claim. A clearinghouse acceptance means the claim passed its edits and the clearinghouse forwarded it to the payer. A payer acceptance means the payer will adjudicate the claim. - `RECEIVED`: A clearinghouse or the payer received the claim but hasn't yet accepted or rejected it. - `INVALID`: Stedi couldn't determine the status because the 277CA carries a status category code Stedi doesn't recognize.
      - object
        - `claimPaymentInformation` ClaimPaymentInformationSummary, required: A summary of the claim payment information the payer reported for a claim in an 835 ERA. Each record corresponds to one CLP loop in the ERA.
          - `checkOrEftTraceNumber` string: The check number for check payments, or the EFT trace number for electronic payments. Use it to match this claim payment information to the funds the payer sent.
          - `claimPaymentAmount` string, required: The amount the payer paid on the claim. This is the charge amount less all adjustments, and can be positive, zero, or negative.
          - `id` string, required: A unique identifier for the claim payment information record within Stedi.
          - `patientResponsibilityAmount` string: The amount the patient owes, such as a deductible, copay, or coinsurance.
          - `processedAt` string, date-time, required: The time Stedi processed the 835 ERA that reported this claim payment information.
          - `statusCode` 'PROCESSED_AS_PRIMARY' | 'PROCESSED_AS_SECONDARY' | 'PROCESSED_AS_TERTIARY' | 'DENIED' | 'PROCESSED_AS_PRIMARY_FORWARDED_TO_ADDITIONAL_PAYERS' | 'PROCESSED_AS_SECONDARY_FORWARDED_TO_ADDITIONAL_PAYERS' | 'PROCESSED_AS_TERTIARY_FORWARDED_TO_ADDITIONAL_PAYERS' | 'REVERSAL_OF_PREVIOUS_PAYMENT' | 'NOT_OUR_CLAIM_FORWARDED_TO_ADDITIONAL_PAYERS' | 'PREDETERMINATION_PRICING_ONLY', required: The status the payer assigned to the claim in the 835 ERA. - `PROCESSED_AS_PRIMARY`: The payer processed the claim as the primary payer. - `PROCESSED_AS_SECONDARY`: The payer processed the claim as the secondary payer. - `PROCESSED_AS_TERTIARY`: The payer processed the claim as the tertiary payer. - `DENIED`: The payer denied the claim. - `PROCESSED_AS_PRIMARY_FORWARDED_TO_ADDITIONAL_PAYERS`: The payer processed the claim as the primary payer and forwarded it to additional payers. - `PROCESSED_AS_SECONDARY_FORWARDED_TO_ADDITIONAL_PAYERS`: The payer processed the claim as the secondary payer and forwarded it to additional payers. - `PROCESSED_AS_TERTIARY_FORWARDED_TO_ADDITIONAL_PAYERS`: The payer processed the claim as the tertiary payer and forwarded it to additional payers. - `REVERSAL_OF_PREVIOUS_PAYMENT`: The payer reversed a payment it reported earlier. The amounts are negative, so they cancel the earlier payment. - `NOT_OUR_CLAIM_FORWARDED_TO_ADDITIONAL_PAYERS`: The payer isn't responsible for the claim and forwarded it to additional payers. - `PREDETERMINATION_PRICING_ONLY`: The payer priced the claim without paying it.
          - `totalClaimChargeAmount` string, required: The total charge amount of the claim.
  - `nextPageToken` string: Token you can supply in subsequent requests to retrieve the next page of results. If absent, there are no more results.

## Other responses

- `400`: GetClaimTimeline400Error 400 response
- `401`: AuthenticationFailedException 401 response
- `403`: GetClaimTimeline403Error 403 response
- `404`: GetClaimTimeline404Error 404 response
- `429`: GetClaimTimeline429Error 429 response
- `500`: GetClaimTimeline500Error 500 response

## Changes

- **2026-09-08** `9191e8cf4519`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stedi/apis/stedi-healthcare-claims/changes/claims/:id/timeline/get.md)

---

[API](https://skmtc.dev/stedi/apis/stedi-healthcare-claims.md) - [All operations](https://skmtc.dev/stedi/apis/stedi-healthcare-claims/llms.txt) - [OpenAPI document](https://skmtc.dev/stedi/apis/stedi-healthcare-claims/revisions/b4f2a7ab03b0?raw)