All blogs

Introducing Stedi's Institutional Claims X12 API endpoint

Sep 10, 2025

Products

You can now submit 837I institutional claims as X12 EDI using the new Institutional Claims X12 API endpoint.

Most Stedi customers submit 837I claims using our JSON-based Institutional Claims endpoint. JSON is familiar and easy to work with. You can build an integration faster.

But if you already work with X12, converting to JSON wastes time. The new endpoint accepts X12 directly.

Previously, X12 submissions of 837I claims required SFTP. With SFTP, you have to wait for files to get errors or validation. With the API, you get instant responses. Development is faster, and debugging is easier.

Use the Institutional Claims X12 endpoint

To use the endpoint, send a POST request to the https://healthcare.us.stedi.com/2024-04-01/change/medicalnetwork/institutionalclaims/v1/raw-x12-submission endpoint. Include an 837I X12 payload in the request body’s x12 field:

curl --request POST \
  --url "https://healthcare.us.stedi.com/2024-04-01/change/medicalnetwork/institutionalclaims/v1/raw-x12-submission" \
  --header "Authorization: <api_key>" \
  --header "Content-Type: application/json" \
  --data '{
    "x12": "ISA*00*          *00*          *ZZ*001690149382   *ZZ*STEDITEST      *240630*0847*^*00501*000000001*0*T*>~GS*HC*001690149382*STEDITEST*20240630*084744*000000001*X*005010X223A2~ST*837*3456*005010X223A2~BHT*0019*00*0123*20061123*1023*CH~NM1*41*2*PREMIER BILLING SERVICE*****46*TGJ23~PER*IC*JERRY*TE*7176149999~NM1*40*2*AETNA*****46*AETNA~HL*1**20*1~NM1*85*2*TEST HOSPITAL*****XX*1234567890~N3*123 HOSPITAL ST~N4*NEW YORK*NY*10001~REF*EI*123456789~HL*2*1*22*1~SBR*P********CI~NM1*IL*1*DOE*JOHN****MI*123456789~NM1*PR*2*AETNA*****PI*AETNA~HL*3*2*23*0~PAT*19~NM1*QC*1*DOE*JOHN~N3*123 MAIN ST~N4*NEW YORK*NY*10001~DMG*D8*19800101*M~CLM*26403774*150***11>B>1*Y*A*Y*I~DTP*472*D8*20240101~REF*D9*17312345600006351~NM1*82*1*SMITH*JANE****XX*1234567890~PRV*AT*PXC*207Q00000X~LX*1~SV2*0450*HC>99213*150****1~DTP*472*D8*20240101~SE*29*3456~GE*1*000000001~IEA*1*000000001~"
  }'

Stedi validates the EDI and sends the claim to the payer.

The endpoint returns a response from Stedi in JSON. The JSON contains information about the claim you submitted and whether the submission was successful:

{
  "claimReference": {
    "correlationId": "01J1M588QT2TAV2N093GNJ998T",
    "formatVersion": "5010",
    "patientControlNumber": "26403774",
    "payerID": "AETNA",
    "rhclaimNumber": "01J1M588QT2TAV2N093GNJ998T",
    "serviceLines": [
      {
        "lineItemControlNumber": "1"
      }
    ],
    "timeOfResponse": "2024-07-10T22:05:32.203Z"
  },
  "controlNumber": "000000001",
  "httpStatusCode": "200 OK",
  "meta": {
    "traceId": "b727b8e7-1f00-4011-bc6e-e41444d406d8"
  },
  "payer": {
    "payerID": "AETNA",
    "payerName": "Aetna"
  },
  "status": "SUCCESS",
  "tradingPartnerServiceId": "AETNA"
}

For complete details, check out the Institutional Claims (837I) Raw X12 API reference.

Try it free

The Institutional Claims X12 endpoint is available for all paid Stedi developer accounts.

To try it out, request a free trial. Most teams are up and running in under a day.

Twitter

Blog

View all blogs

Get started with Stedi

Automate healthcare transactions with developer-friendly APIs that support thousands of payers. Contact us to learn more and speak to the team.

Book a demo

Get updates on what’s new at Stedi

(332) 378-5040

228 Park Ave S
Ste 58460
New York, NY 10003

Get updates on what’s new at Stedi

Backed by

Stedi is a registered trademark of Stedi, Inc. All names, logos, and brands of third parties listed on our site are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Our use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.

Service Terms

Privacy Notice

Manage Privacy Choices

(332) 378-5040

228 Park Ave S
Ste 58460
New York, NY 10003

Product

Transaction enrollment

EDI platform