Real-Time Claim Status (276/277) Raw X12
Submit a 276/277 real-time claim status check in raw X12 EDI format
/change/medicalnetwork/claimstatus/v2/raw-x12You may need to submit a 276 real-time claim status request when you don't receive a 277CA or 835 ERA response from the payer within your expected timeframe. This endpoint is ideal if you have an existing system that generates X12 EDI files and you want to send them through Stedi.
- Call this endpoint with a payload in 276 X12 EDI format.
- The request must be for a production claim that has entered the payer's processing system. Requests for test claims or claims that the payer hasn't yet accepted won't return results.
- Providing too much information can negatively affect the results. You should start with our recommended base request.
- Stedi validates the EDI and sends the transaction to the payer.
- The endpoint returns a synchronous 277 claim status response from the payer in JSON format. The response contains information about the claims matching the criteria you provided in the request and their current status.
The response may contain information about more than one claim, if the payer has multiple claims on file that match the information you provided.
A production Stedi API Key for authentication.
Response
The status information for the claim referenced in the original claim status request.
The payer may return multiple claims in the response if they have more than one claim on file that matches the information you provided.
Array item
The control number the payer provided in the claim status response. This is used to identify the transaction.
Information about the dependent listed in the referenced claim.
Show attributes
Show attributes
A globally unique identifier for this claim status check across all Stedi accounts. It's formatted as csc_<uuid>. For example: csc_550e8400-e29b-41d4-a716-446655440000. You can use this ID to track this claim status check and to construct deep links to claim status checks in the Stedi portal.
The syntax error code in the 999 Implementation Acknowledgment. It indicates the type of error (if present) in the EDI request syntax. Visit IK502 in the Implementation Acknowledgment specification for a complete list.
Metadata about the response.
Show attributes
Information about the payer listed in the referenced claim.
Show attributes
Information about the billing and/or service providers related to the referenced claim.
Array item
The control number for the transaction.
The status of the entire claim.
Information about the subscriber listed in the referenced claim.
Show attributes
An ID for the payer you identified in the original claim status request. This value may differ from the tradingPartnerServiceId you submitted in the original request because it reflects the payer's internal concept of their ID, not necessarily the ID Stedi uses to route requests to this payer.
The acknowledgment code in the 999 Implementation Acknowledgment, an EDI file generated by the payer to acknowledge receipt of the claim status request. It indicates whether the claim status request was accepted or rejected due to errors in the EDI request syntax.
Issues with your claim status request that could affect the results, or information about the response. For example, warnings can help explain why the request was rejected.
Array item
The raw X12 EDI response, which is either a 277 Status Request Response or a 999 Implementation Acknowledgment. A 999 indicates that the request data failed validation. Common failure reasons are missing required segments and invalid values.
curl --request POST \ --url "https://healthcare.us.stedi.com/2024-04-01/change/medicalnetwork/claimstatus/v2/raw-x12" \ --header "Authorization: <api_key>" \ --header "Content-Type: application/json" \ --data '{ "x12": "ISA*00* *00* *ZZ*SENDER *ZZ*RECEIVER *250916*2048*^*00501*000000001*0*T*>~GS*HR*SENDERGS*RECEIVERGS*20250916*204811*1*X*005010X212~ST*276*0001*005010X212~BHT*0010*13*ABC276XXX*20250915*1425~HL*1**20*1~NM1*PR*2*UNITEDHEALTHCARE*****PI*87726~HL*2*1*21*1~NM1*41*2*PROVIDER NAME*****46*123456789~HL*3*2*19*1~NM1*1P*2*PROVIDER NAME*****XX*1999999984~HL*4*3*22*0~DMG*D8*19710101~NM1*IL*1*DOE*JANE****MI*UHC123456~TRN*1*123456789~DTP*472*RD8*20250630-20250702~SE*14*0001~GE*1*1~IEA*1*000000001~" }'{
"claims": [
{
"claimStatus": {
"amountPaid": "108.77",
"checkIssueDate": "2025-07-17",
"checkNumber": "123456789",
"claimServiceDate": "20250701",
"effectiveDate": "2025-07-17",
"paidDate": "2025-07-15",
"patientAccountNumber": "12345678",
"statusCategoryCode": "F1",
"statusCategoryCodeValue": "Finalized/Payment - The claim/line has been paid.",
"statusCode": "65",
"statusCodeValue": "Claim/line has been paid.",
"submittedAmount": "267.54",
"trackingNumber": "0123456789",
"tradingPartnerClaimNumber": "0123456789"
},
"serviceDetails": [
{
"service": {
"amountPaid": "108.77",
"procedureId": "90837",
"serviceIdQualifier": "Health Care Financing Administration Common Procedural Coding System (HCPCS) Codes",
"serviceIdQualifierCode": "HC",
"submittedAmount": "267.54",
"submittedUnits": "1"
},
"status": [
{
"effectiveDate": "2025-07-17",
"statusCategoryCode": "F1",
"statusCategoryCodeValue": "Finalized/Payment - The claim/line has been paid.",
"statusCode": "107",
"statusCodeValue": "Processed according to contract provisions (Contract refers to provisions that exist between the Health Plan and a Provider of Health Care Services)."
}
]
}
]
}
],
"controlNumber": "123456789",
"payer": {
"organizationName": "UNITEDHEALTHCARE",
"payerIdentification": "87726"
},
"providers": [
{
"npi": "1999999984",
"organizationName": "Provider Name",
"providerType": "BillingProvider"
}
],
"subscriber": {
"firstName": "Jane",
"lastName": "Doe",
"memberId": "UHC123456"
},
"tradingPartnerServiceId": "87726",
"x12": "ISA*00* *00* *ZZ*RECEIVER *ZZ*SENDER *250912*1718*^*00501*123456789*0*T*:~GS*HN*RECEIVERGS*SENDERGS*20250912*171842*1*X*005010X212~ST*277*1001*005010X212~BHT*0010*08*0123456789*20250912*171841*DG~HL*1**20*1~NM1*PR*2*UNITEDHEALTHCARE*****PI*87726~HL*2*1*21*1~NM1*41*2*PROVIDER NAME*****46*1234567890~HL*3*2*19*1~NM1*1P*2*PROVIDER NAME*****XX*1999999984~HL*4*3*22*0~NM1*IL*1*DOE*JANE****MI*UHC123456~TRN*2*0123456789~STC*F1:65*20250717**267.54*108.77*20250715**20250717*123456789~REF*1K*0123456789~REF*EJ*12345678~DTP*472*D8*20250701~SVC*HC:90837:GT*267.54*108.77****1~STC*F1:107*20250717~DTP*472*D8*20250701~SE*19*1001~GE*1*1~IEA*1*123456789~"
}