Sign in

v50

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-07-24226771.6 MB
Claim submission

Submit an 837I institutional claim in raw X12 EDI format

post/change/medicalnetwork/institutionalclaims/v1/raw-x12-submission

Headers

Idempotency-Keystring

A unique string to identify this request to the server. The key can be up to 255 characters. You can safely retry requests with the same idempotency key within 24 hours of making the first request. This prevents you from sending duplicate claims due to network errors or other intermittent failures. Learn more.

A unique string to identify this request to the server. The key can be up to 255 characters. You can safely retry requests with the same idempotency key within 24 hours of making the first request. This prevents you from sending duplicate claims due to network errors or other intermittent failures. Learn more.

Request body

x12string required

Response

InstitutionalClaimsRawX12Submission 200 response

controlNumberstring

An identifier for the transaction.

editStatusstring

This shape is deprecated: Currently not used.

httpStatusCode'200 OK' | '400 BAD_REQUEST' | '403 FORBIDDEN'

Stedi can return the following status codes:

  • 200: Stedi successfully generated the X12 EDI claim format required by the payer. It does not indicate whether the payer has accepted the claim - the payer will respond later with a 277CA containing this information. Learn more about 277CAs.
  • 400: The request contains one or more problems with the claim data. Examples include missing required fields, invalid values, or incorrect data types. The response includes a message describing the problem.
  • 403: The request is not permitted, such as using a test API key to submit a production transaction.
statusstring

The status of the claim submission.

tradingPartnerServiceIdstring

An ID for the payer you identified in the original claim. 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.

x12string

A 277CA claim acknowledgment acceptance or rejection from Stedi in X12 EDI format. It indicates whether the claim has passed Stedi's claim edits.

When the claim fails one or more edits, the 277CA contains STC segments with information about each error. These are the same error codes that appear in the errors array.

Note that this 277CA only indicates whether Stedi has accepted or rejected the claim submission. You may receive additional 277CA acceptances or rejections as the claim is routed to the payer.