v50

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

Submit an 837P professional claim in JSON format

post/change/medicalnetwork/professionalclaims/v3/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

claimIdentifier'31' | 'CH' | 'RP'

A code specifying the type of transaction. Defaults to CH if not provided.

  • 31: Only for use by state Medicaid agencies performing post payment recovery.
  • CH: Use when the transaction contains only fee for service claims or claims with at least one chargeable line item. Also use when it's not clear whether a transaction contains claims or capitated encounters, or if the transaction contains a mix of claims and capitated encounters.
  • RP: Use for capitated encounters. Also use when the transaction is being sent to an entity for purposes other than adjudication of a claim. For example, when you're sending the claim to a state health agency that is using the claim for health data reporting purposes.
controlNumberstring

Not currently used.

tradingPartnerNamestring

This is the payer's business name, like Cigna or Aetna.

tradingPartnerServiceIdstring required

The payer ID. Visit the Payer Network for a complete list.

  • You can send requests using the primary payer ID, the Stedi payer ID, or any alias listed in the payer record.
  • You must include leading 0 characters - payer IDs are alphanumeric strings and must be treated as complete strings, not integers. For example, use 00540 for SISCO, not 540.
usageIndicatorstring

Whether you want to send a test or production claim. This property also allows you to filter claims in the Stedi portal by production or test data. By default, this property is set to P for production data. Use T to designate a claim as test data.

Response

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