--- title: "GET /claims" method: GET path: "/claims" --- # GET /claims `GET /claims` ## Request - Base URL: `https://claims.us.stedi.com/2025-03-07` - URL: `https://claims.us.stedi.com/2025-03-07/claims` - Auth: API key in header `Authorization` Retrieve a paginated list of claim records, newest first. Filter by status, patient control numbers, or submission time ## Query parameters - `pageSize` number: The maximum number of claims 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. - `status` ClaimStatus[]: 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. - `patientControlNumbers` string[]: Filter for claims with specific patient control numbers. You can include this parameter multiple times to filter for multiple patient control numbers. - `submittedAfter` string, date-time: Filter for claims with `submittedAt` after this time. - `submittedBefore` string, date-time: Filter for claims with `submittedAt` before this time. ## Response `200` ListClaims 200 response - ListClaimsResponseContent: A page of claims. - `items` ClaimSummary[], 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` 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 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` 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. - `status` 'SUBMITTED' | 'RECEIVED' | 'ACCEPTED' | 'REJECTED' | 'PROCESSED' | 'DENIED' | 'UNKNOWN', 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. - `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. - `statusReportedBy` '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. - `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). - `submittedAt` string, date-time, required: The time Stedi processed the claim's most recent submission. - `totalClaimChargeAmount` string, required: The total charge amount of the claim's most recent submission. - `totalClaimPaidAmount` string: 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` 'DENTAL' | 'INSTITUTIONAL' | 'PROFESSIONAL', required: The type of claim. Each type corresponds to a different 837 transaction set and paper claim form. - `DENTAL`: An 837D dental claim, the electronic equivalent of the ADA Dental Claim Form. - `INSTITUTIONAL`: An 837I institutional claim, the electronic equivalent of the UB-04 form. - `PROFESSIONAL`: An 837P professional claim, the electronic equivalent of the CMS-1500 form. - `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`: ListClaims400Error 400 response - `401`: AuthenticationFailedException 401 response - `403`: ListClaims403Error 403 response - `404`: ResourceNotFoundException 404 response - `429`: ListClaims429Error 429 response - `500`: ListClaims500Error 500 response ## Changes - **2026-09-08** `9191e8cf4519`: 1 info - endpoint added [Operation history](https://skmtc.dev/stedi/apis/stedi-healthcare-claims/changes/claims/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)