POST
/
claim-attachments
/
submission
cURL
curl --request POST \
  --url https://claims.us.stedi.com/2025-03-07/claim-attachments/submission \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "usageIndicator": "T",
  "relatedExecutionId": "9b491769-052e-4738-93d6-e0b5f6d83f53",
  "claimInformation": {
    "serviceLines": [
      {
        "providerAttachmentControlNumber": "ATTACH123",
        "attachmentDetails": {
          "attachmentId": "4a1b2c3d-4567-89ab-cdef-1234567890ab"
        }
      }
    ]
  }
}'
{
  "tradingPartnerServiceId": "PAYER123",
  "claimAttachmentReference": {
    "correlationId": "att-123456",
    "patientControlNumber": "PCN123456",
    "timeOfResponse": "2025-03-07T12:34:56Z"
  },
  "meta": {
    "traceId": "4a1b2c3d-4567-89ab-cdef-1234567890ab"
  }
}
This endpoint is in beta and is subject to change.
This endpoint submits a 275 claim attachment to a payer.
  1. Call this endpoint with the required information to link the attachment to the correct claim.
  2. Stedi generates the X12 EDI 275 transaction and sends it to the payer.
  3. The endpoint returns summary information about the submission.
This endpoint is for 837 claims submitted in JSON format. If your system already generates X12 EDI, you can send attachments through the Submit Claim Attachment (275) Raw X12 endpoint instead. This endpoint only supports unsolicited attachments.
Visit Claim attachments for a full how-to guide.

Authorizations

​
Authorization
string
header
required

A Stedi API Key for authentication.

Body

application/json

Submit a claim attachment.

​
claimInformation
object
required

Information about the associated 837 claim.

​
usageIndicator
enum<string>

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.

Available options:
P,
T
​
relatedTransactionId
string

The transaction ID of the claim related to this attachment. You can find this value in the transaction processed event for the claim or on the claim's transaction details page in the Stedi portal.

You must provide either the relatedTransactionId or relatedExecutionId property in the request.

Required string length: 36
​
relatedExecutionId
string

The file execution ID of the claim related to this attachment. The referenced file must contain exactly one transaction, an 837 claim. You can find this value in the meta.traceId property of the claim submission API response or in the file delivered event Stedi generates when it delivers your claim to the payer.

You must provide either the relatedTransactionId or relatedExecutionId property in the request.

Required string length: 36

Response

SubmitClaimAttachment 200 response

Response from submitting a claim attachment

​
tradingPartnerServiceId
string

An ID for the payer you identified in the related transaction. This value may differ from the tradingPartnerServiceId you submitted in the original claim request because it reflects the payer's internal concept of their ID, not necessarily the ID Stedi uses to route requests to this payer.

Required string length: 2 - 80
​
claimAttachmentReference
object

Information about the claim attachment.

​
meta
object

Metadata from Stedi about the request.