POST
/
change
/
medicalnetwork
/
professionalclaims
/
v3
/
submission
curl --request POST \
  --url https://healthcare.us.stedi.com/2024-04-01/change/medicalnetwork/professionalclaims/v3/submission \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Stedi-Partnership-Id: <stedi-partnership-id>' \
  --header 'Stedi-Response-Type: <stedi-response-type>' \
  --header 'Stedi-Transaction-Setting-Id: <stedi-transaction-setting-id>' \
  --data '{
  "controlNumber": "555123",
  "tradingPartnerServiceId": "6400",
  "submitter": {
    "organizationName": "Test Data Health Services, Inc.",
    "contactInformation": {
      "name": "Test Data Health Services, Inc.",
      "phoneNumber": "5552223333"
    }
  },
  "receiver": {
    "organizationName": "Cigna"
  },
  "subscriber": {
    "memberId": "U7777788888",
    "paymentResponsibilityLevelCode": "P",
    "subscriberGroupName": "Cigna",
    "firstName": "John",
    "lastName": "Anon",
    "gender": "M",
    "dateOfBirth": "20000101",
    "groupNumber": "3335555",
    "address": {
      "address1": "2222 Random St",
      "city": "New York",
      "state": "NY",
      "postalCode": "100130000"
    }
  },
  "billing": {
    "providerType": "BillingProvider",
    "npi": "1235600834",
    "employerId": "832675429",
    "taxonomyCode": "2084P0800X",
    "organizationName": "Therapy Associates",
    "address": {
      "address1": "123 Some St",
      "address2": "Floor 1",
      "city": "New York",
      "state": "NY",
      "postalCode": "100130000"
    },
    "contactInformation": {
      "name": "Test Data Health Services, Inc.",
      "phoneNumber": "5553334444"
    }
  },
  "claimInformation": {
    "claimFilingCode": "CI",
    "patientControlNumber": "22266555",
    "claimChargeAmount": "109.20",
    "placeOfServiceCode": "02",
    "claimFrequencyCode": "1",
    "signatureIndicator": "Y",
    "planParticipationCode": "A",
    "benefitsAssignmentCertificationIndicator": "Y",
    "releaseInformationCode": "Y",
    "healthCareCodeInformation": [
      {
        "diagnosisTypeCode": "ABK",
        "diagnosisCode": "F1111"
      }
    ],
    "serviceFacilityLocation": {
      "organizationName": "Smith Associates",
      "address": {
        "address1": "1234 Other St",
        "city": "New York",
        "state": "NY",
        "postalCode": "100130000"
      },
      "npi": "4541648844"
    },
    "serviceLines": [
      {
        "serviceDate": "20240101",
        "professionalService": {
          "procedureIdentifier": "HC",
          "procedureCode": "90837",
          "procedureModifiers": [
            "95"
          ],
          "lineItemChargeAmount": "109.20",
          "measurementUnit": "UN",
          "serviceUnitCount": "1",
          "compositeDiagnosisCodePointers": {
            "diagnosisCodePointers": [
              "1"
            ]
          }
        },
        "renderingProvider": {
          "providerType": "RenderingProvider",
          "npi": "4541648844",
          "taxonomyCode": "111YP2000X",
          "firstName": "Jane",
          "lastName": "Smith"
        }
      }
    ]
  },
  "tradingPartnerName": "Cigna"
}'
{
  "status": "SUCCESS",
  "controlNumber": "555123",
  "tradingPartnerServiceId": "6400",
  "claimReference": {
    "correlationId": "01HTCX97F6XS6F2K22D4KD59TK",
    "patientControlNumber": "22266555",
    "timeOfResponse": "2024-04-01T13:23:54.255Z",
    "payerId": "6400",
    "formatVersion": "5010",
    "rhclaimNumber": "01HTCX97F6XS6F2K22D4KD59TK"
  },
  "httpStatusCode": "200 OK",
  "meta": {
    "traceId": "a7f7c912-77f7-489d-96fc-c4ab3b5c33fc"
  },
  "payer": {
    "payerName": "Cigna",
    "payerId": "6400"
  }
}

A direct replacement for the Change Healthcare (CHC) Claim Submission API.

  • You call this endpoint with a JSON payload in the CHC Professional Claims V3 format.
  • Stedi automatically maps CHC payer IDs to our IDs.
  • Stedi translates the JSON to the X12 EDI 837 format and delivers it to the payer or peer clearinghouse.
  • The endpoint returns a synchronous response in the CHC Professional Claims V3 JSON response format.

Differences from Change Healthcare’s APIs

The following differences are notable when using Stedi’s APIs instead of CHC APIs.

Receive claim responses and reports via webhook

In order to receive 277 Claim Responses and 835 ERAs using CHC APIs, you needed to poll the Claims Responses and Reports v2 API using the Convert Report 277 and Convert Report 835 operations.

Making a Claim with Change

With Stedi, you only need to make a single API call to submit the claim. Stedi then automatically delivers the 277 and 835 transactions to your API using webhooks. You receive the 277 and 835 in the same format as Change’s Convert Report APIs.

Making a Claim with Stedi

Receive 999 Acknowledgments via webhook

We return the 999 in Stedi’s JSON format through webhooks.

View files

You can view every file that Stedi sends and receives on your behalf on the Files page in the Stedi app.

Authorizations

Authorization
string
headerrequired

API key authentication via the 'Authorization' header

Headers

Stedi-Partnership-Id
string
required

The partnership ID.

Stedi-Response-Type
enum<string>
required

Temporary parameter used to control the returned response shape.

Available options:
change-beta
Stedi-Transaction-Setting-Id
string
required

The outbound transaction setting ID.

Body

application/json
controlNumber
string

Not currently used, but we may be used in the future.

tradingPartnerServiceId
string
required

This is the Payer ID. Visit the Payer Network for a complete list.

submitter
object
required

Loop: 1000A

receiver
object
required

Loop: 1000B

subscriber
object
required

Loop: 2000B

dependent
object

LOOP 2000C

providers
object[]

setting providers deprecated, please set all providers individually by it's type.

claimInformation
object
required

Loop2300

payToAddress
object

N3 and N4

payToPlan
object

2010AC

payerAddress
object

N3 and N4

usageIndicator
string

The Interchange Usage Indicator (ISA-15) in the X12 EDI file. You only need to set this field if you want to be able to filter claims in the Stedi app by production or test data. By default, this field is set to P for production data. Use T to designate a file as test data.

billing
object
required

Loop: 2000A

referring
object

Loop: 2420F

rendering
object

Loop: 2420A

ordering
object

Loop: 2420E, Setting ProviderType equal to OrderingProvider is deprecated, please use ClaimInformation.serviceLines.orderingProvider

supervising
object

Loop: 2420D

tradingPartnerName
string

Loop 2010BB NM103

Response

200 - application/json
status
string

Status of claim

controlNumber
string

Transaction Set Control Number

tradingPartnerServiceId
string

Payer ID

claimReference
object

Collection of info specific to a given claim

errors
object[]

List of errors

httpStatusCode
enum<string>
Available options:
100 CONTINUE,
101 SWITCHING_PROTOCOLS,
102 PROCESSING,
103 CHECKPOINT,
200 OK,
201 CREATED,
202 ACCEPTED,
203 NON_AUTHORITATIVE_INFORMATION,
204 NO_CONTENT,
205 RESET_CONTENT,
206 PARTIAL_CONTENT,
207 MULTI_STATUS,
208 ALREADY_REPORTED,
226 IM_USED,
300 MULTIPLE_CHOICES,
301 MOVED_PERMANENTLY,
302 FOUND,
302 MOVED_TEMPORARILY,
303 SEE_OTHER,
304 NOT_MODIFIED,
305 USE_PROXY,
307 TEMPORARY_REDIRECT,
308 PERMANENT_REDIRECT,
400 BAD_REQUEST,
401 UNAUTHORIZED,
402 PAYMENT_REQUIRED,
403 FORBIDDEN,
404 NOT_FOUND,
405 METHOD_NOT_ALLOWED,
406 NOT_ACCEPTABLE,
407 PROXY_AUTHENTICATION_REQUIRED,
408 REQUEST_TIMEOUT,
409 CONFLICT,
410 GONE,
411 LENGTH_REQUIRED,
412 PRECONDITION_FAILED,
413 PAYLOAD_TOO_LARGE,
413 REQUEST_ENTITY_TOO_LARGE,
414 URI_TOO_LONG,
414 REQUEST_URI_TOO_LONG,
415 UNSUPPORTED_MEDIA_TYPE,
416 REQUESTED_RANGE_NOT_SATISFIABLE,
417 EXPECTATION_FAILED,
418 I_AM_A_TEAPOT,
419 INSUFFICIENT_SPACE_ON_RESOURCE,
420 METHOD_FAILURE,
421 DESTINATION_LOCKED,
422 UNPROCESSABLE_ENTITY,
423 LOCKED,
424 FAILED_DEPENDENCY,
425 TOO_EARLY,
426 UPGRADE_REQUIRED,
428 PRECONDITION_REQUIRED,
429 TOO_MANY_REQUESTS,
431 REQUEST_HEADER_FIELDS_TOO_LARGE,
451 UNAVAILABLE_FOR_LEGAL_REASONS,
500 INTERNAL_SERVER_ERROR,
501 NOT_IMPLEMENTED,
502 BAD_GATEWAY,
503 SERVICE_UNAVAILABLE,
504 GATEWAY_TIMEOUT,
505 HTTP_VERSION_NOT_SUPPORTED,
506 VARIANT_ALSO_NEGOTIATES,
507 INSUFFICIENT_STORAGE,
508 LOOP_DETECTED,
509 BANDWIDTH_LIMIT_EXCEEDED,
510 NOT_EXTENDED,
511 NETWORK_AUTHENTICATION_REQUIRED
meta
object

Meta data about the request

editStatus
string
editResponses
object[]
payer
object
failure
object