Retrieve Claim

Retrieve summary information for a claim, including current processing status and key details from its most recent submission

GET /claims/{id}

Retrieve a single claim record with summary information about its most recent submission, including processing status, charge and paid totals, patient name, dates of service, and claim type. Use this endpoint when you need to check a claim's current status without fetching the full submission history.

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. Note: 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 the claim record with summary information from the most recent submission, including processing status, charge and paid totals, patient information, and dates of service.

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

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 the Create Professional Claim JSON endpoint response or from the List Claims lifecycle endpoint.

Response

application/json

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 · 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 · 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 · 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 · String Required Length : 1 - 38

The patient control number you assigned to the claim.

patientName · Object

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

firstName · patientName.firstName · String

The patient's first name.

lastName · patientName.lastName · String

The patient's last name.

middleName · patientName.middleName · String

The patient's middle name.

suffix · patientName.suffix · String

The patient's name suffix.

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 · 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 · 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 · String Required Format : date-time

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

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

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

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 · 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

Request

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

Response

{
  "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"
}