---
title: "POST /change/medicalnetwork/professionalclaims/v3/raw-x12-submission"
method: POST
path: "/change/medicalnetwork/professionalclaims/v3/raw-x12-submission"
tags: ["Claim submission"]
---

# POST /change/medicalnetwork/professionalclaims/v3/raw-x12-submission

`POST /change/medicalnetwork/professionalclaims/v3/raw-x12-submission`

Submit an 837P professional claim in raw X12 EDI format

## Headers

- `Idempotency-Key` string — 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](https://www.stedi.com/docs/api-reference/index#idempotency-keys).

## Request body

- ClaimsRawX12SubmissionRequestContent
  - `x12` string, required

## Response `200`

ClaimsRawX12Submission 200 response

- ClaimsRawX12SubmissionResponseContent
  - `claimReference` ClaimReference — Information about the claim.
    - `claimType` string — This shape is deprecated: Currently not used.
    - `correlationId` string — An identifier Stedi assigns to the claim.
    - `customerClaimNumber` string — A tracking number that Stedi assigns to the claim.
    - `formatVersion` string — The X12 EDI version Stedi used to generate the claim for the payer. This is always `5010`.
    - `patientControlNumber` string — The `patientControlNumber` from the original request, if supplied. This is a unique identifier that you assign to the claim so you can track the claim and correlate it with responses from the payer.
    - `payerID` string — This shape is deprecated: Please use payerId.
    - `payerId` string — The payer's ID. This is the same as the `tradingPartnerServiceId`.
    - `rhclaimNumber` string — A tracking number Stedi assigns to the claim. This is the same as the `correlationId`.
    - `serviceLines` ServiceLineResponseIdentifier[] — Contains a unique identifier for each service line, listed in the order the service lines were included in the claim. You can use these identifiers to correlate payer responses to specific service lines.
      - `lineItemControlNumber` string — A unique identifier for the service line, matching the value provided for the `claimInformation.serviceLines[].providerControlNumber` property in the claim submission. If you didn't provide a value for `providerControlNumber`, this property contains a randomly generated a ULID for the service line.
    - `submitterId` string — Stedi's ID for the entity that submitted the claim.
    - `timeOfResponse` string — A timestamp for Stedi's response to the claim submission.
  - `controlNumber` string — An identifier for the transaction.
  - `editResponses` EditResponse[] — Currently not used.
    - `allowOverride` string
    - `badData` string
    - `claimCorePath` string
    - `editActivity` string
    - `editName` string
    - `element` string
    - `errorDescription` string
    - `fieldIndex` string
    - `loop` string
    - `phaseID` string
    - `qualifierCode` string
    - `referenceID` string
    - `segment` string
  - `editStatus` string — This shape is deprecated: Currently not used.
  - `errors` ClaimsError[] — Errors resulting from claim edits. You must review and fix these errors before resubmitting.
    - `code` string — The error code.
    - `description` string — The description of the error code.
    - `followupAction` string — Recommended followup actions to correct the error.
    - `location` string — Where the error is located in the original request.
    - `value` string — The value for the data causing the error.
  - `failure` Failure — Currently not used.
    - `code` string
    - `description` string
  - `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](https://www.stedi.com/docs/healthcare/receive-claim-responses#response-types). - `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.
  - `meta` ResponseMeta — Metadata from Stedi about the request.
    - `applicationMode` string — Indicates where this request can be found for support.
    - `billerId` string — The biller ID assigned to this request.
    - `senderId` string — The sender ID assigned to this request.
    - `submitterId` string — The submitter ID assigned to this request.
    - `traceId` string — The file execution ID, a unique identifier assigned to the processed file within the Stedi platform.
  - `payer` ClaimsPayer — Information about the payer for the submitted claim.
    - `payerID` string — This shape is deprecated: Please use payerId.
    - `payerId` string — The payer's ID. This is the same as the `tradingPartnerServiceId`.
    - `payerName` string — The payer's business name, such as Aetna or Cigna.
  - `status` string — The status of the claim submission.
  - `tradingPartnerServiceId` string — 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.
  - `warnings` ClaimsWarning[] — A list of warnings. Currently not used.
    - `code` string — A machine-readable code indicating the type of problem.
    - `description` string — A human-readable description of the problem.
  - `x12` string — A [277CA claim acknowledgment](https://www.stedi.com/docs/healthcare/claim-responses-overview#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.

## Other responses

- `400` — ValidationException 400 response
- `403` — AccessDeniedException 403 response
- `404` — ResourceNotFoundException 404 response
- `409` — ConflictException 409 response
- `422` — RequestChangedException 422 response
- `429` — ThrottlingException 429 response
- `500` — InternalFailureException 500 response
- `503` — ServiceUnavailableException 503 response
- `504` — GatewayTimeoutException 504 response

---

[API](https://skmtc.net/stedi/apis/stedi-healthcare.md) · [All operations](https://skmtc.net/stedi/apis/stedi-healthcare/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stedi/stedi-healthcare/revisions/4ba02a47bfc5/schema)