POST
/
change
/
medicalnetwork
/
institutionalclaims
/
v1
/
submission
cURL
curl --request POST \
  --url https://healthcare.us.stedi.com/2024-04-01/change/medicalnetwork/institutionalclaims/v1/submission \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "usageIndicator": "T",
  "tradingPartnerName": "UnitedHealthcare",
  "tradingPartnerServiceId": "87726",
  "submitter": {
    "organizationName": "Test Facility",
    "contactInformation": {
      "name": "Test Facility",
      "phoneNumber": "2225551234"
    },
    "taxId": "123456789"
  },
  "receiver": {
    "organizationName": "UnitedHealthcare"
  },
  "subscriber": {
    "memberId": "98765",
    "paymentResponsibilityLevelCode": "P",
    "firstName": "JANE",
    "lastName": "DOE",
    "groupNumber": "67890"
  },
  "claimInformation": {
    "claimFilingCode": "ZZ",
    "patientControlNumber": "<YOUR-CLAIM-ID>",
    "claimChargeAmount": "500.00",
    "placeOfServiceCode": "11",
    "claimFrequencyCode": "0",
    "planParticipationCode": "C",
    "benefitsAssignmentCertificationIndicator": "Y",
    "releaseInformationCode": "Y",
    "principalDiagnosis": {
      "qualifierCode": "ABK",
      "principalDiagnosisCode": "R45851"
    },
    "serviceLines": [
      {
        "assignedNumber": "0",
        "serviceDate": "20241015",
        "serviceDateEnd": "20241015",
        "lineItemControlNumber": "111222333",
        "institutionalService": {
          "serviceLineRevenueCode": "90",
          "lineItemChargeAmount": "500.00",
          "measurementUnit": "UN",
          "serviceUnitCount": "1",
          "procedureIdentifier": "HC",
          "procedureCode": "H0001"
        }
      }
    ],
    "claimCodeInformation": {
      "admissionTypeCode": "3",
      "admissionSourceCode": "9",
      "patientStatusCode": "30"
    },
    "claimDateInformation": {
      "admissionDateAndHour": "202409091000",
      "statementBeginDate": "20241015",
      "statementEndDate": "20241015"
    }
  },
  "providers": [
    {
      "providerType": "BillingProvider",
      "npi": "1999999976",
      "employerId": "123456789",
      "organizationName": "Test Facility",
      "address": {
        "address1": "123 Mulberry Street",
        "city": "Seattle",
        "state": "WA",
        "postalCode": "111135272"
      },
      "contactInformation": {
        "name": "Test Facility",
        "phoneNumber": "2065551234"
      }
    },
    {
      "providerType": "AttendingProvider",
      "npi": "1999999976",
      "firstName": "Doctor",
      "lastName": "Provider",
      "contactInformation": {
        "name": "name"
      }
    }
  ]
}'
{
  "status": "SUCCESS",
  "controlNumber": "123456789",
  "tradingPartnerServiceId": "87726",
  "claimReference": {
    "correlationId": "01JABEX6DPF4FCT2J0Y0SGFCY8",
    "patientControlNumber": "00001111222233334444",
    "timeOfResponse": "2024-10-16T20:04:32.962Z",
    "formatVersion": "5010",
    "claimType": "INST",
    "rhClaimNumber": "01JABEX6DPF4FCT2J0Y0SGFCY8"
  },
  "httpStatusCode": "200 OK",
  "payer": {
    "payerName": "UnitedHealthcare",
    "payerID": "87726"
  },
  "meta": {
    "traceId": "a742ab42-a6f3-4232-a88c-197d341afdbe"
  }
}
This endpoint sends 837I institutional claims to payers.
  1. Call this endpoint with a JSON payload.
  2. Stedi translates your request to the X12 837 EDI format and sends it to the payer.
  3. The endpoint returns a response from Stedi in JSON format containing information about the claim you submitted and whether the submission was successful.
Visit Submit institutional claims for a full how-to guide.

Authorizations

Authorization
string
header
required

A Stedi API Key for authentication.

Headers

Stedi-Transaction-Setting-Id
string

The outbound transaction setting ID. This option only needs to be specified if you're using a non-default release of the Institutional Claims guide.

Body

application/json
tradingPartnerServiceId
string
required

This is 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.

submitter
object
required

The entity submitting the healthcare claim. This is an organization, such as a hospital or other treatment center.

receiver
object
required

The entity responsible for the payment of the claim, such as an insurance company or government agency.

subscriber
object
required

The person or entity who is the primary policyholder for the health plan or a dependent with their own member ID.

  • When a dependent has a unique, payer-assigned member ID, treat them as the subscriber for the claim submission - include their information here and omit the dependent object from the request.
  • You must set the dateOfBirth and gender properties when the subscriber is the patient. Stedi determines that the subscriber is the patient when the dependent object is not included in the request.
  • If either dateOfBirth or gender is set, you must include both properties. You can either include both properties or neither within a single request.
claimInformation
object
required

Information about the healthcare claim. Note that the objects and properties marked as required are required for all claims, while others are conditionally required, depending on type of claim and claim circumstances. For example, you must always provide the claimChargeAmount, but you only need to provide the otherSubscriberInformation object in coordination of benefits scenarios. When you include a conditionally required object, you must provide all of its required properties.

controlNumber
string

Not currently used.

Required string length: 9
dependent
object

Dependent who received the medical care associated with the claim. When the dependent has their own member ID for the health plan, you should include the dependent's information in the subscriber object instead. To check whether a dependent has a member ID, submit an Eligibility Check to the payer. The payer returns the dependent's member ID in the dependents.memberId property in the response, if present.

providers
object[]

Another way to send information for each provider relevant to the claim. This object overwrites the information you send in the billing, referring, rendering, and attending objects. Note that your request must include information about the billing provider either here or within the billing object.

Required array length: 1 - 4 elements
billingPayToPlanName
object

Use for subrogation payment requests. If you include this information, you must also set the claimInformation.otherSubscriberInformation.payerPaidAmount to the amount the payer (for example, Medicaid) actually paid.

billingPayToAddressName
object

Use when the address for payment is different than that of the billing provider for this claim.

operatingPhysician
object

Information about the individual with primary responsibility for performing the surgical procedure(s) listed in the claim. Required when a surgical procedure code is listed on the claim. Use this object for operating physicians that apply to the entire claim.

This should be an individual, not an organization, and you should supply at least the physician's lastName and an identifier, which is typically the npi.

otherOperatingPhysician
object

Information about any other operating physician involved in the surgical procedures listed in the claim. Required when another operating physician is involved in the surgical procedures listed in the claim. Use this object for physicians that apply to the entire claim.

This should be an individual, not an organization, and you should supply at least the physician's lastName and an identifier, which is typically the npi.

payerAddress
object

Address information for the entity responsible for payment of the claim, listed in the receiver object.

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

billing
object

Information about the billing provider.

  • You must include either the provider's Social Security Number (SSN) or their Employer Identification Number (EIN), but not both.
  • The provider's National Provider Identifier (NPI) is required, if one is assigned.
  • You must also supply the provider's organizationName.
referring
object

Information about the provider who referred the patient for care.

  • Include this object only when the referring provider is different than the provider listed in the attending object.
  • Use this object for providers that apply to the entire claim.
  • This should be an individual, not an organization, and you should supply at least the provider's lastName and an identifier, which is typically the npi.
rendering
object

Information about the provider who delivered the medical services or non-surgical procedures listed in the claim. This must be an individual, not an organization, and you must supply at least the provider's lastName and an identifier, which is typically the npi. The provider's firstName is also required, if applicable.

Include this object when all of the following are true:

  • The rendering provider is different than the provider listed in the attending object.
  • The provider applies to the entire claim or to at least one service line. For example, if a claim had two service lines with two different rendering providers, you would include the provider for the first service line here and leave the claimInformation.serviceLines.renderingProvider object for that service line blank. Then, you would specify the second provider in the appropriate service line's claimInformation.serviceLines.renderingProvider object.
  • State or federal regulatory requirements call for a combined claim. A combined claim includes both facility and professional components, such as a Medicaid clinic bill or a critical access hospital claim.
attending
object

Information about the individual who has overall responsibility for the patient's medical care and treatment reported in the claim. This information is required when the claim contains any services other than non-scheduled transportation claims.

This provider should be an individual, not an organization, and you should supply at least the provider's lastName and an identifier, which is typically the npi.

tradingPartnerName
string

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

claimIdentifier
enum<string>

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.
Available options:
31,
CH,
RP

Response

InstitutionalClaimsSubmission 200 response

status
string

The status of the claim submission.

controlNumber
string

An identifier for the transaction.

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.

claimReference
object

Information about the claim.

errors
object[]

A list of errors. Currently not used.

warnings
object[]

A list of warnings.

httpStatusCode
enum<string>

A 200 response indicates that 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. A 400 response indicates one or more problems with the claim data in the request. Examples include missing required fields, invalid values, or incorrect data types. The response includes a message describing the problem.

Available options:
200 OK,
400 BAD_REQUEST
meta
object

Metadata from Stedi about the request.

editStatus
string

Currently not used.

editResponses
object[]

Currently not used.

payer
object

Information about the payer for the submitted claim.

failure
object

Currently not used.