Real-Time Claim Status Raw X12

Submit a 276/277 real-time claim status check in raw X12 EDI format

POST /change/medicalnetwork/claimstatus/v2/raw-x12

You 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.

1. 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.
2. Stedi validates the EDI and sends the transaction to the payer.
3. 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.

Visit Check claim status for a complete how-to guide.

Authorizations

Authorization · Required Header

A Stedi API Key for authentication.

Body

application/json

x12 · String Required

Response

application/json

ClaimStatusRawX12 200 response

claims · Array of Objects

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.

claimStatus · claims[].claimStatus · Object

The status, required action, and paid information of a claim or service line.

amountPaid · claims[].claimStatus.amountPaid · String

The total amount paid for the claim. May be zero when no payment is being made. Some payers can provide the adjudicated payment amount before they issue the remittance.

checkIssueDate · claims[].claimStatus.checkIssueDate · String Regex pattern: ^\d{4}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])$

The date the payer issued the check for payment. This may also contain a non-payment remittance advice date, if available from the payer.

checkNumber · claims[].claimStatus.checkNumber · String

The check identification number or electronic funds transfer (EFT) trace number. This number is used to track the payment. This may also contain a non-payment remittance advice Trace Number (835 or paper), if available from the payer.

claimServiceDate · claims[].claimStatus.claimServiceDate · String

Either a single date (formatted as YYYYMMDD) or a range of dates (formatted as YYYYMMDD-YYYYMMDD) identifying the period of service related to the claim. This property is derived from the service level dates.

clearingHouseClaimNumber · claims[].claimStatus.clearingHouseClaimNumber · String

The claim number provided by the clearinghouse.

effectiveDate · claims[].claimStatus.effectiveDate · String Regex pattern: ^\d{4}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])$

The date the claim was placed in this status by the payer's adjudication process.

entity · claims[].claimStatus.entity · String

The description of the entityCode. For example, Home Health Care.

Possible values

Health Maintenance Organization (HMO)

Oncology Center

Kidney Dialysis Unit

Preferred Provider Organization (PPO)

Acute Care Hospital

entityCode · claims[].claimStatus.entityCode · String

Code identifying the organizational entity, physical location, property, or individual associated with the statusCode. For example 1G - Oncology Center.

Visit Claims code lists for a complete list.

Possible values

1E

1G

1H

1I

1O

paidDate · claims[].claimStatus.paidDate · String Regex pattern: ^\d{4}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])$

This is the date of denial or approval for the claim. This date may or may not be the same as the issue date of the check, EFT, or non-payment remittance. Some payers can provide this date before they issue the remittance.

patientAccountNumber · claims[].claimStatus.patientAccountNumber · String

The patient account number provided by the service provider in the original claim. You can use this value to correlate the claim status response to the original claim.

statusCategoryCode · claims[].claimStatus.statusCategoryCode · String

The status category code. Visit Claim Status Category Codes in the official X12 documentation for a complete list.

statusCategoryCodeValue · claims[].claimStatus.statusCategoryCodeValue · String

The description of the statusCategoryCode.

statusCode · claims[].claimStatus.statusCode · String

The status code used to identify the status of an entire claim or a service line. For example, 20 - Accepted for Processing.

This is either a Health Care Claim Status Code or a National Council for Prescription Drug Programs (NCPDP) Reject/Payment Code, when the status is related to pharmacy claims.

Visit [Claim Status Codes](Health Care Claim Status Code in the official X12 documentation or the NCPDP website for a complete list of codes and their values.

statusCodeValue · claims[].claimStatus.statusCodeValue · String

The description of the statusCode.

submittedAmount · claims[].claimStatus.submittedAmount · String

The total charges submitted for the claim. The total claim charge may change from the submitted claim total charge based on claims processing instructions, such as claim splitting. Some payers may not store the original submitted charge. Some HMO encounters supply zero as the amount of original charges.

trackingNumber · claims[].claimStatus.trackingNumber · String

This is the trace or reference number of the original claim status request.

tradingPartnerClaimNumber · claims[].claimStatus.tradingPartnerClaimNumber · String

An identifier for the claim, assigned by the payer.

serviceDetails · claims[].serviceDetails · Array of Objects

Information about specific service lines and their status. Payers may not return service line details for all claims, even when you requested them.

service · claims[].serviceDetails[].service · Object

Information about a service line listed in the referenced claim.

amountPaid · claims[].serviceDetails[].service.amountPaid · String

The amount paid for the service line, expressed as a decimal. For example, 100.00.

procedureId · claims[].serviceDetails[].service.procedureId · String

Identifying number for product or service.

procedureModifiers · claims[].serviceDetails[].service.procedureModifiers · Array of Strings Items: 1 - 4

Procedure modifier codes that provide additional information about the service performed.

revenueCode · claims[].serviceDetails[].service.revenueCode · String

The National Uniform Billing Committee revenue code.

serviceIdQualifier · claims[].serviceDetails[].service.serviceIdQualifier · String

The definition of the serviceIdQualifierCode. For example, American Dental Association Codes.

serviceIdQualifierCode · claims[].serviceDetails[].service.serviceIdQualifierCode · String

A code identifying the type/source of the procedureId. Visit Claims code lists for a complete list.

Possible values

AD

ER

HC

HP

IV

submittedAmount · claims[].serviceDetails[].service.submittedAmount · String

The amount submitted for the service line, expressed as a decimal. For example, 100.00. This is the line item total on the current claim service status.

submittedUnits · claims[].serviceDetails[].service.submittedUnits · String

The number of units of service submitted.

status · claims[].serviceDetails[].status · Array of Objects

Information about the status, required action, and paid information of a service line.

effectiveDate · claims[].serviceDetails[].status[].effectiveDate · String Regex pattern: ^\d{4}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])$

The date the service line was placed in this status by the payer's adjudication process.

entity · claims[].serviceDetails[].status[].entity · String

The description of the entityCode. For example, Public Health Service Facility.

Possible values

Health Maintenance Organization (HMO)

Oncology Center

Kidney Dialysis Unit

Preferred Provider Organization (PPO)

Acute Care Hospital

entityCode · claims[].serviceDetails[].status[].entityCode · String

The code identifying the organizational entity, physical location, property, or individual associated with the statusCode. For example, 4H - Emergency Department.

Visit Claims code lists for a complete list.

Possible values

1E

1G

1H

1I

1O

statusCategoryCode · claims[].serviceDetails[].status[].statusCategoryCode · String

The category code for the status. Visit Claim Status Category Codes in the official X12 documentation for a complete list.

statusCategoryCodeValue · claims[].serviceDetails[].status[].statusCategoryCodeValue · String

The description of the statusCategoryCode.

statusCode · claims[].serviceDetails[].status[].statusCode · String

The status code used to identify the status of an entire service line. This is either a Health Care Claim Status Code or a National Council for Prescription Drug Programs Reject/Payment Code, when the status is related to pharmacy claims.

statusCodeValue · claims[].serviceDetails[].status[].statusCodeValue · String

The description of the statusCode.

controlNumber · String

The control number the payer provided in the claim status response. This is used to identify the transaction.

dependent · Object

Information about the dependent listed in the referenced claim.

dateOfBirth · dependent.dateOfBirth · String Regex pattern: ^\d{4}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])$

The dependent's date of birth.

firstName · dependent.firstName · String Required Length: 1 - 35

The dependent's first name as specified on their insurance policy.

gender · dependent.gender · String

A code indicating the dependent's gender. If the claim set the dependent's gender to U for unknown, you should omit this property from the claim status request.

Possible values

M

F

groupNumber · dependent.groupNumber · String Length: 1 - 50

The group number associated with the subscriber and dependent's insurance policy.

lastName · dependent.lastName · String Required Length: 1 - 60

The dependent's last name as specified on their insurance policy.

errorResponse · Object

code · errorResponse.code · String

description · errorResponse.description · String

errors · errorResponse.errors · Array of Objects

code · errorResponse.errors[].code · String

The error code.

description · errorResponse.errors[].description · String

The description of the error code.

field · errorResponse.errors[].field · String

The attribute that caused the error.

followupAction · errorResponse.errors[].followupAction · String

Follow-up actions to correct the error.

location · errorResponse.errors[].location · String

Where the error occurred within the request syntax. If this is a network or system error, there is no location attribute.

value · errorResponse.errors[].value · String

The value that caused the error.

transactionIdentifier · errorResponse.transactionIdentifier · Object

customerTransactionId · errorResponse.transactionIdentifier.customerTransactionId · String

transactionId · errorResponse.transactionIdentifier.transactionId · String

implementationTransactionSetSyntaxError · String

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.

meta · Object

Metadata about the response.

applicationMode · meta.applicationMode · String

Identifies where this request can be found for support.

billerId · meta.billerId · String

The biller ID assigned to this request.

senderId · meta.senderId · String

The sender ID assigned to this request.

submitterId · meta.submitterId · String

The submitter ID assigned to this request.

traceId · meta.traceId · String

The unique ID assigned to this request within Stedi.

payer · Object

Information about the payer listed in the referenced claim.

centersForMedicareAndMedicaidServicePlanId · payer.centersForMedicareAndMedicaidServicePlanId · String

The payer's Health Plan ID (HPID) or Other Entity Identifier (OEID).

contactInformation · payer.contactInformation · Object

electronicDataInterChangeAccessNumber · payer.contactInformation.electronicDataInterChangeAccessNumber · String

The payer's Electronic Data Interchange Access number.

email · payer.contactInformation.email · String

The payer's email address.

fax · payer.contactInformation.fax · String

The payer's fax number, without separators. For example, 5551123345 for 555-112-3345

name · payer.contactInformation.name · String

The payer contact name.

phone · payer.contactInformation.phone · String

The payer's telephone number. Phone numbers are formatted as AAABBBCCCC, where AAA represents the area code, BBB represents the telephone number prefix, and CCCC represents the telephone number. Phone numbers are provided without separators, such as dashes or parentheses. For example, 5551123345 for 555-112-3345.

phoneExtension · payer.contactInformation.phoneExtension · String

The payer's telephone extension.

organizationName · payer.organizationName · String

The payer's organization name. For example UNITEDHEALTHCARE.

payerIdentification · payer.payerIdentification · String

The payer's identification number. This is the tradingPartnerServiceId.

providers · Array of Objects

Information about the billing and/or service providers related to the referenced claim.

etin · providers[].etin · String Length: 2 - 80

The Electronic Transmitter Identification Number (ETIN).

firstName · providers[].firstName · String Length: 1 - 35

The provider's first name.

lastName · providers[].lastName · String Length: 1 - 60

The provider's last name.

npi · providers[].npi · String Regex pattern: ^\d{10}$

The National Provider Identification (NPI) number.

organizationName · providers[].organizationName · String Length: 1 - 60

The provider's organization name.

providerType · providers[].providerType · String Required

Identifies the type of provider related to the referenced healthcare claim.

Possible values

BillingProvider

ServiceProvider

spn · providers[].spn · String Deprecated Length: 2 - 80

The service provider number.

taxId · providers[].taxId · String Regex pattern: ^\d{9}$

The Taxpayer Identification Number (TIN).

tin · providers[].tin · String Length: 2 - 80

reassociationKey · String

The control number for the transaction.

status · String

The status of the entire claim.

subscriber · Object

Information about the subscriber listed in the referenced claim.

dateOfBirth · subscriber.dateOfBirth · String Regex pattern: ^\d{4}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])$

The subscriber's date of birth.

firstName · subscriber.firstName · String Required Length: 1 - 35

The subscriber's first name as specified on their policy.

gender · subscriber.gender · String

A code indicating the subscriber's gender. If the claim set the subscriber's gender to U for unknown, you should omit this property from the claim status request.

Possible values

M

F

groupNumber · subscriber.groupNumber · String Length: 1 - 50

The group number associated with the subscriber's insurance policy.

lastName · subscriber.lastName · String Required Length: 1 - 60

The subscriber's last name as specified on their policy. The subscriber can be an individual or a business entity.

memberId · subscriber.memberId · String Required Length: 2 - 80

The subscriber's insurance member ID. This is the unique identifier for the subscriber on the insurance policy.

tradingPartnerServiceId · String

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.

transactionSetAcknowledgement · String

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.

x12 · String

The raw X12 response from the payer.

cURL

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~"
  }'

JavaScript

const body = JSON.stringify({
  "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~"
})

fetch("https://healthcare.us.stedi.com/2024-04-01/change/medicalnetwork/claimstatus/v2/raw-x12", {
  headers: {
    "Authorization": "<api_key>"
  },
  body
})

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
  "strings"
)

func main() {
  url := "https://healthcare.us.stedi.com/2024-04-01/change/medicalnetwork/claimstatus/v2/raw-x12"
  body := strings.NewReader(`{
    "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~"
  }`)
  req, _ := http.NewRequest("POST", url, body)
  req.Header.Add("Authorization", "<api_key>")
  req.Header.Add("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

Python

import requests

url = "https://healthcare.us.stedi.com/2024-04-01/change/medicalnetwork/claimstatus/v2/raw-x12"
body = {
  "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~"
}
response = requests.request("POST", url, json = body, headers = {
  "Authorization": "<api_key>",
  "Content-Type": "application/json"
})

print(response.text)

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;
import java.net.http.HttpRequest.BodyPublishers;

var body = BodyPublishers.ofString("""{
  "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~"
}""");
HttpClient client = HttpClient.newBuilder()
  .connectTimeout(Duration.ofSeconds(10))
  .build();

HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
  .uri(URI.create("https://healthcare.us.stedi.com/2024-04-01/change/medicalnetwork/claimstatus/v2/raw-x12"))
  .header("Content-Type", "application/json")
  .header("Authorization", "<api_key>")
  .POST(body)
  .build();

try {
  HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
  System.out.println("Status code: " + response.statusCode());
  System.out.println("Response body: " + response.body());
} catch (Exception e) {
  e.printStackTrace();
}

200

{
  "claims": [
    {
      "claimStatus": {
        "amountPaid": "108.77",
        "checkIssueDate": "20250717",
        "checkNumber": "123456789",
        "claimServiceDate": "20250701",
        "effectiveDate": "20250717",
        "paidDate": "20250715",
        "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": "20250717",
              "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*STEDI          *01*117151744      *250912*1718*^*00501*123456789*0*P*:~GS*HN*STEDI*117151744*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~"
}

400

{
  "code": "string",
  "message": "string"
}

403

{
  "code": "string",
  "message": "string"
}

404

{
  "code": "string",
  "message": "string"
}

429

{
  "code": "string",
  "message": "string"
}

500

{
  "code": "string",
  "message": "string"
}

503

{
  "code": "string",
  "message": "string"
}

504

{
  "code": "string",
  "message": "string"
}