List Claims

Retrieve a paginated list of claim records, newest first. Filter by status, patient control numbers, or submission time

GET /claims

Retrieve a paginated list of claim records with filters for status, patient control numbers, and submission date ranges.

Each claim record contains summary information about its most recent submission, including processing status, charge and paid totals, patient information, and dates of service. Use this endpoint when you need to monitor claims across your account, build a claims dashboard, or search for specific claims.

1. Call this endpoint with optional query parameters to filter by status, patient control numbers, or submission date range.

2. Stedi returns a paginated list of claim records, ordered by most recent submission first. Each claim record shows summary information from that claim's most recent submission.

To view the full history of submissions, acknowledgments, and payments for a specific claim, use the Retrieve Claim Timeline endpoint.

Authorizations

Authorization · Required Header

A production Stedi API Key for authentication.

Query Parameters

pageSize · Number Range : ≥ 1 and ≤ 500

The maximum number of claims 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.

status · Array of Strings Items : 1 - 20

Filter for claims with specific statuses. You can include this parameter multiple times to filter for multiple statuses.

• SUBMITTED: You submitted the claim to Stedi but haven't yet received a 277CA response from Stedi or the payer.
• RECEIVED: The clearinghouse or payer has acknowledged receipt of the claim. This doesn't mean the claim has been accepted for adjudication.
• ACCEPTED: The payer has accepted the claim into their adjudication system and it's currently being processed or adjudicated.
• REJECTED: Either Stedi or the payer rejected the claim before the start of adjudication. This can happen even when the payer has acknowledged receipt.
• PROCESSED: The payer has adjudicated the claim. Check totalClaimPaidAmount to see how much was paid.
• DENIED: The payer has denied the claim.
• UNKNOWN: Stedi can't determine a single status for this claim, usually because the payer's responses are mixed or incomplete.

Possible values

SUBMITTED

RECEIVED

ACCEPTED

REJECTED

PROCESSED

patientControlNumbers · Array of Strings Items : 1 - 20

Filter for claims with specific patient control numbers. You can include this parameter multiple times to filter for multiple patient control numbers.

submittedAfter · String Format : date-time

Filter for claims with submittedAt after this time.

submittedBefore · String Format : date-time

Filter for claims with submittedAt before this time.

Response

application/json

items · Array of Objects Required

The claim records on this page, newest first by submittedAt. Each claim record includes summary information about the most recent submission, including processing status, charge and paid totals, patient name, dates of service, and claim type.

datesOfService · items[].datesOfService · Object

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

end · items[].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[].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[].id · String Required Regex pattern : ^(clm_)?[0-7][0-9A-HJKMNP-TV-Z]{25}$

A unique identifier for the claim within Stedi. This ID stays the same throughout the claim's entire lifecycle. For example, the claim ID is the same for the initial submission and any resubmissions.

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

The patient control number you assigned to the claim.

patientName · items[].patientName · Object

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

firstName · items[].patientName.firstName · String

The patient's first name.

lastName · items[].patientName.lastName · String

The patient's last name.

middleName · items[].patientName.middleName · String

The patient's middle name.

suffix · items[].patientName.suffix · String

The patient's name suffix.

status · items[].status · String Required

The claim's current processing status.

• SUBMITTED: You submitted the claim to Stedi but haven't yet received a 277CA response from Stedi or the payer.
• REJECTED: Either Stedi or the payer rejected the claim before the start of adjudication. This can happen even when the payer has acknowledged receipt.
• ACCEPTED: The payer has accepted the claim into their adjudication system and it's currently being processed or adjudicated.
• RECEIVED: The clearinghouse or payer has acknowledged receipt of the claim. This doesn't mean the claim has been accepted for adjudication.
• PROCESSED: The payer has adjudicated the claim. Check totalClaimPaidAmount to see how much was paid.
• DENIED: The payer has denied the claim.
• UNKNOWN: Stedi can't determine a single status for this claim, usually because the payer's responses are mixed or incomplete.

Possible values

SUBMITTED

RECEIVED

ACCEPTED

REJECTED

PROCESSED

statusReportedBy · items[].statusReportedBy · String Required

The entity that reported the claim's current 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.

Possible values

PAYER

CLEARINGHOUSE

stediPayerId · items[].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.

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

The time Stedi processed the claim's most recent submission.

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

The total charge amount of the claim's most recent submission.

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

The total amount payers have paid on this claim, summed across every claim payment information record linked to it. Excludes claim payment information with the PREDETERMINATION_PRICING_ONLY status, where the payer priced the claim without paying it. Reversals carry a negative amount, so they subtract from the total. Absent until Stedi receives an 835 ERA for the claim.

type · items[].type · String Required

The type of claim. Each type corresponds to a different 837 transaction set.

• PROFESSIONAL: An 837P professional claim, the electronic equivalent of the CMS-1500 form.
• INSTITUTIONAL: An 837I institutional claim, the electronic equivalent of the UB-04 form.
• DENTAL: An 837D dental claim, the electronic equivalent of the ADA Dental Claim Form.

Possible values

DENTAL

INSTITUTIONAL

PROFESSIONAL

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?pageSize=100" \
  --header "Authorization: <api_key>"

Response

{
  "items": [
    {
      "datesOfService": {
        "start": "2026-01-05"
      },
      "id": "clm_01K6XFP3TZ8RA9X84963NMW40N",
      "patientControlNumber": "123456",
      "patientName": {
        "firstName": "John",
        "lastName": "Doe",
        "middleName": "Michael",
        "suffix": "Jr"
      },
      "status": "PROCESSED",
      "statusReportedBy": "PAYER",
      "stediPayerId": "ABCDE",
      "submittedAt": "2026-01-16T10:00:00Z",
      "totalClaimChargeAmount": "832.00",
      "totalClaimPaidAmount": "200.00",
      "type": "PROFESSIONAL"
    },
    {
      "id": "clm_01K6XFP3TZ8RA9X84963NMW41P",
      "patientControlNumber": "123457",
      "patientName": {
        "firstName": "Jane",
        "lastName": "Doe"
      },
      "status": "SUBMITTED",
      "statusReportedBy": "CLEARINGHOUSE",
      "stediPayerId": "ABCDE",
      "submittedAt": "2026-01-06T10:00:00Z",
      "totalClaimChargeAmount": "125.00",
      "type": "PROFESSIONAL"
    }
  ],
  "nextPageToken": "eyJsYXN0SWQiOiIwMUs2WEZQMyJ9"
}