---
title: "POST /change/medicalnetwork/claimstatus/v2"
method: POST
path: "/change/medicalnetwork/claimstatus/v2"
tags: ["Real-time claim status"]
---

# POST /change/medicalnetwork/claimstatus/v2

`POST /change/medicalnetwork/claimstatus/v2`

Submit a 276/277 real-time claim status check in JSON format

## Request body

- ClaimStatusRequestContent
  - `controlNumber` string — Stedi generates a control number for each claim status check, so you don’t need to include this property in your request.
  - `dependent` Member
    - `dateOfBirth` string — The dependent's date of birth.
    - `firstName` string, required — The dependent's first name as specified on their insurance policy.
    - `gender` 'M' | 'F' — A code indicating the dependent's gender. If the claim set the dependent's gender to `U` for unknown, you should omit this property from the claim status request.
    - `groupNumber` string — The group number associated with the subscriber and dependent's insurance policy.
    - `lastName` string, required — The dependent's last name as specified on their insurance policy.
    - `suffix` string — The dependent's name suffix, such as Sr. or III. Only include the dependent's personal name suffix - **don't** include professional or academic titles, such as M.D. or MBA.
  - `encounter` ClaimStatusEncounter — Information about the referenced claim or claims for which you want to retrieve status information. - We recommend supplying a date range that is at least plus or minus 7 days from the date of the services listed in the claim, using the `beginningDateOfService` and `endDateOfService` properties. The payer may have stored a different date for the encounter than the one in your records, so providing a date range increases the likelihood that the payer will find a match. - Don't submit future dates - only submit date ranges up to and including today's date. Some payers reject requests containing future service dates.
    - `beginningDateOfService` string — The date the service began.
    - `billingType` string — The billing type reference ID. For example, the billing type for inpatient services is `111`.
    - `clearingHouseClaimNumber` string — The claim number provided by the clearinghouse.
    - `endDateOfService` string — The date the service ended.
    - `locationIdentifier` string — The application or location identifier. Required if the application or location system identifier is known.
    - `patientAccountNumber` string — The patient account number provided by the service provider.
    - `pharmacyPrescriptionNumber` string — The patient's pharmacy prescription number.
    - `submittedAmount` string — The total charges submitted for the claim. Note that not all payer systems retain the original submitted charges; they are sometimes changed during processing.
    - `trackingNumber` string — This is the tracking number assigned to the claim status request. It is returned in the response as `claims[].claimStatus.trackingNumber`. If the payer requires a tracking number and you do not supply one, Stedi generates a tracking number for you from a UUID.
    - `tradingPartnerClaimNumber` string — An identifier for the claim, assigned by the payer.
  - `providers` StatusRequestProvider[], required — Information about the billing provider and (optionally) service providers related to the referenced claim. - Exactly one billing provider is **required** in this array. Requests that include only a service provider are rejected with a `400` error. - For each provider, you must set the `providerType` and one of the following identifiers: `npi`, `taxId`, or `etin`. - When the `providerType` = `BillingProvider`, we recommend setting `etin` as the identifier.
    - `etin` string — The Electronic Transmitter Identification Number (ETIN). This identifier is preferred if the payer specifically assigned one for the provider. If not, most payers will accept the provider's [NPI](https://www.stedi.com/docs/healthcare/national-provider-identifier) or TIN instead.
    - `firstName` string — The provider's first name. Use when the provider is an individual.
    - `lastName` string — The provider's last name. Use when the provider is an individual.
    - `npi` string — The [National Provider Identification (NPI)](https://www.stedi.com/docs/healthcare/national-provider-identifier) number.
    - `organizationName` string — The provider's organization name. Use when the provider is not an individual, such as a hospital or clinic.
    - `providerType` 'BillingProvider' | 'ServiceProvider', required — Identifies the type of provider related to the referenced healthcare claim.
    - `spn` string — Deprecated; The service provider number. Use `npi` to identify the service provider instead.
    - `taxId` string — The Taxpayer Identification Number (TIN).
    - `tin` string
  - `serviceLineInformation` ServiceLineInformation — Identify a service line listed in the referenced claim. Used to request status for a specific service line.
    - `lineItemChargeAmount` string, required — The original submitted charge for the service line, expressed as a decimal. For example, `100.00`.
    - `lineItemControlNumber` string — An identifier for the service line. This matches the `claimInformation.serviceLines[].providerControlNumber` submitted for the service line in the original claim.
    - `procedureCode` string, required — The procedure code.
    - `procedureModifiers` string[] — A modifier code that clarifies or improves the reporting accuracy of the associated `procedureCode`. If not required, do not send.
    - `productOrServiceIDQualifier` 'AD' | 'ER' | 'HC' | 'HP' | 'IV' | 'N4' | 'NU' | 'WK', required — A code identifying the type/source of the descriptive number used in Product/Service ID. Visit [Claims code lists](https://www.stedi.com/docs/healthcare/claims-code-lists#product-or-service-id-qualifier) for a complete list.
    - `revenueCode` string — The revenue code for the service line. This is the National Uniform Billing Committee revenue code.
    - `serviceLineDate` string, required — The date the service line began.
    - `serviceLineEndDate` string — The date the service line ended.
    - `unitsOfServiceCount` string, required — The number of units of service for the service line.
  - `serviceLinesInformation` ServiceLineInformation[]
    - `lineItemChargeAmount` string, required — The original submitted charge for the service line, expressed as a decimal. For example, `100.00`.
    - `lineItemControlNumber` string — An identifier for the service line. This matches the `claimInformation.serviceLines[].providerControlNumber` submitted for the service line in the original claim.
    - `procedureCode` string, required — The procedure code.
    - `procedureModifiers` string[] — A modifier code that clarifies or improves the reporting accuracy of the associated `procedureCode`. If not required, do not send.
    - `productOrServiceIDQualifier` 'AD' | 'ER' | 'HC' | 'HP' | 'IV' | 'N4' | 'NU' | 'WK', required — A code identifying the type/source of the descriptive number used in Product/Service ID. Visit [Claims code lists](https://www.stedi.com/docs/healthcare/claims-code-lists#product-or-service-id-qualifier) for a complete list.
    - `revenueCode` string — The revenue code for the service line. This is the National Uniform Billing Committee revenue code.
    - `serviceLineDate` string, required — The date the service line began.
    - `serviceLineEndDate` string — The date the service line ended.
    - `unitsOfServiceCount` string, required — The number of units of service for the service line.
  - `subscriber` ClaimStatusSubscriber, required — Information about the subscriber listed in the referenced claim. - You must set both the `dateOfBirth` and `gender` properties when the subscriber is the patient unless the gender is unknown. 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 unless the gender is unknown.
    - `dateOfBirth` string — The subscriber's date of birth.
    - `firstName` string, required — The subscriber's first name as specified on their policy.
    - `gender` 'M' | 'F' — A code indicating the subscriber's gender. If the claim set the subscriber's gender to `U` for unknown, you should omit this property from the claim status request.
    - `groupNumber` string — The group number associated with the subscriber's insurance policy.
    - `lastName` string, required — The subscriber's last name as specified on their policy. The subscriber can be an individual or a business entity.
    - `memberId` string, required — The subscriber's insurance member ID. This is the unique identifier for the subscriber on the insurance policy.
    - `suffix` string — The subscriber's name suffix, such as Jr., Sr., or III. Only include the subscriber's personal name suffix - **don't** include professional or academic titles, such as M.D. or MBA.
  - `tradingPartnerName` string — This is the payer name, such as Cigna or Aetna.
  - `tradingPartnerServiceId` string, required — The payer ID. Visit the [Payer Network](https://www.stedi.com/healthcare/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`.

## Response `200`

ClaimStatus 200 response

- ClaimStatusResponseContent
  - `claims` Claim[] — The status information for the claim referenced in the original claim status request. The payer may return multiple claims in the response if they have more than one claim on file that matches the information you provided.
    - `claimStatus` ComponentsSchemasClaimStatus — The status, required action, and paid information of a claim or service line.
      - `amountPaid` string — The total amount paid for the claim. May be zero when no payment is being made. Some payers can provide the adjudicated payment amount before they issue the remittance.
      - `checkIssueDate` string — The date the payer issued the check for payment. This may also contain a non-payment remittance advice date, if available from the payer. This value is returned in ISO 8601 date format (YYYY-MM-DD). For example: 2026-03-04.
      - `checkNumber` string — The check identification number or electronic funds transfer (EFT) trace number. This number is used to track the payment. This may also contain a non-payment remittance advice Trace Number (835 or paper), if available from the payer.
      - `claimServiceDate` string — Either a single date (formatted as `YYYYMMDD`) or a range of dates (formatted as `YYYYMMDD-YYYYMMDD`) identifying the period of service related to the claim. This property is derived from the service level dates.
      - `clearingHouseClaimNumber` string — The claim number provided by the clearinghouse.
      - `effectiveDate` string — The date the claim was placed in this status by the payer's adjudication process. This value is returned in ISO 8601 date format (YYYY-MM-DD). For example: 2026-03-04.
      - `entity` 'Health Maintenance Organization (HMO)' | 'Oncology Center' | 'Kidney Dialysis Unit' | 'Preferred Provider Organization (PPO)' | 'Acute Care Hospital' | 'Provider' | 'Military Facility' | 'University, College or School' | 'Outpatient Surgicenter' | 'Physician, Clinic or Group Practice' | 'Long Term Care Facility' | 'Extended Care Facility' | 'Psychiatric Health Facility' | 'Laboratory' | 'Retail Pharmacy' | 'Home Health Care' | 'Federal, State, County or City Facility' | 'Third-Party Administrator' | 'Miscellaneous Health Care Facility' | 'Non-Health Care Miscellaneous Facility' | 'Church Operated Facility' | 'Partnership' | 'Public Health Service Facility' | 'Veterans Administration Facility' | 'Public Health Service Indian Service Facility' | 'Hospital Unit of an Institution (prison hospital, college infirmary, etc.)' | 'Dependent' | 'Hospital Unit Within an Institution for the Mentally Retarded' | 'Tuberculosis and Other Respiratory Diseases Facility' | 'Obstetrics and Gynecology Facility' | 'Eye, Ear, Nose and Throat Facility' | 'Rehabilitation Facility' | 'Orthopedic Facility' | 'Chronic Disease Facility' | 'Other Specialty Facility' | 'Children's General Facility' | 'Children's Hospital Unit of an Institution' | 'Children's Psychiatric Facility' | 'Children's Tuberculosis and Other Respiratory Diseases Facility' | 'Children's Eye, Ear, Nose and Throat Facility' | 'Children's Rehabilitation Facility' | 'Children's Orthopedic Facility' | 'Children's Chronic Disease Facility' | 'Children's Other Specialty Facility' | 'Institution for Mental Retardation' | 'Alcoholism and Other Chemical Dependency Facility' | 'General Inpatient Care for AIDS/ARC Facility' | 'AIDS/ARC Unit' | 'Specialized Outpatient Program for AIDS/ARC' | 'Alcohol/Drug Abuse or Dependency Inpatient Unit' | 'Alcohol/Drug Abuse or Dependency Outpatient Services' | 'Arthritis Treatment Center' | 'Birthing Room/LDRP Room' | 'Burn Care Unit' | 'Cardiac Catherization Laboratory' | 'Open-Heart Surgery Facility' | 'Cardiac Intensive Care Unit' | 'Angioplasty Facility' | 'Chronic Obstructive Pulmonary Disease Service Facility' | 'Emergency Department' | 'Trauma Center (Certified)' | 'Extracorporeal Shock-Wave Lithotripter (ESWL) Unit' | 'Genetic Counseling/Screening Services' | 'Adult Day Care Program Facility' | 'Alzheimer's Diagnostic/Assessment Services' | 'Comprehensive Geriatric Assessment Facility' | 'Emergency Response (Geriatric) Unit' | 'Geriatric Acute Care Unit' | 'Geriatric Clinics' | 'Respite Care Facility' | 'Patient Education Unit' | 'Community Health Promotion Facility' | 'Worksite Health Promotion Facility' | 'Hemodialysis Facility' | 'Home Health Services' | 'Hospice' | 'Medical Surgical or Other Intensive Care Unit' | 'Histopathology Laboratory' | 'Blood Bank' | 'Neonatal Intensive Care Unit' | 'Obstetrics Unit' | 'Occupational Health Services' | 'Organized Outpatient Services' | 'Pediatric Acute Inpatient Unit' | 'Psychiatric Child/Adolescent Services' | 'Psychiatric Consultation-Liaison Services' | 'Psychiatric Education Services' | 'Psychiatric Emergency Services' | 'Psychiatric Geriatric Services' | 'Psychiatric Inpatient Unit' | 'Psychiatric Outpatient Services' | 'Psychiatric Partial Hospitalization Program' | 'Megavoltage Radiation Therapy Unit' | 'Radioactive Implants Unit' | 'Therapeutic Radioisotope Facility' | 'X-Ray Radiation Therapy Unit' | 'CT Scanner Unit' | 'Diagnostic Radioisotope Facility' | 'Magnetic Resonance Imaging (MRI) Facility' | 'Ultrasound Unit' | 'Rehabilitation Inpatient Unit' | 'Rehabilitation Outpatient Services' | 'Reproductive Health Services' | 'Skilled Nursing or Other Long-Term Care Unit' | 'Single Photon Emission Computerized Tomography (SPECT) Unit' | 'Organized Social Work Service Facility' | 'Outpatient Social Work Services' | 'Emergency Department Social Work Services' | 'Sports Medicine Clinic/Services' | 'Hospital Auxiliary Unit' | 'Patient Representative Services' | 'Volunteer Services Department' | 'Outpatient Surgery Services' | 'Organ/Tissue Transplant Unit' | 'Orthopedic Surgery Facility' | 'Occupational Therapy Services' | 'Physical Therapy Services' | 'Recreational Therapy Services' | 'Respiratory Therapy Services' | 'Speech Therapy Services' | 'Women's Health Center/Services' | 'Cardiac Rehabilitation Program Facility' | 'Non-Invasive Cardiac Assessment Services' | 'Emergency Medical Technician' | 'Disciplinary Contact' | 'Case Manager' | 'Place of Occurrence' | 'Contracted Service Provider' | 'Consultant's Office' | 'Subcontractor' | 'Service Supplier' | 'Employer' | 'Receiver' | 'Claimant Authorized Representative' | 'Data Processing Service Bureau' | 'Performed At' | 'Attending Physician' | 'Operating Physician' | 'Other Physician' | 'Corrected Insured' | 'Service Location' | 'Hospital' | 'Rendering Provider' | 'Subscriber's Employer' | 'Billing Provider' | 'Pay-to Provider' | 'Research Institute' | 'Pharmacist' | 'Admitting Surgeon' | 'Commercial Insurer' | 'Assistant Surgeon' | 'Consulting Physician' | 'Ordering Physician' | 'Referring Provider' | 'Dependent Name' | 'Supervising Physician' | 'Person or Other Entity Legally Responsible for a Child' | 'Person or Other Entity With Whom a Child Resides' | 'Previous Employer' | 'Participating Laboratory' | 'Facility' | 'Physical Address' | 'Mail Address' | 'Dependent Insured' | 'Clinic' | 'Other Insured' | 'Guardian' | 'Paramedic' | 'Paramedical Company' | 'Previous Insured' | 'Spouse Insured' | 'Treatment Facility' | 'Healthcare Professional Shortage Area (HPSA) Facility' | 'Home Health Agency' | 'Independent Physicians Association (IPA)' | 'Injection Point' | 'Insured or Subscriber' | 'Insurer' | 'Independent Lab' | 'Legal Representative' | 'Medical Insurance Carrier' | 'Mammography Screening Center' | 'Ordered By' | 'Doctor of Optometry' | 'Oxygen Therapy Facility' | 'Patient Facility' | 'Primary Insured or Subscriber' | 'Primary Care Provider' | 'Prior Insurance Carrier' | 'Third Party Reviewing Preferred Provider Organization (PPO)' | 'Third Party Repricing Preferred Provider Organization (PPO)' | 'Primary Payer' | 'Party to Receive Test Report' | 'Party performing certification' | 'Pickup Address' | 'Pharmacy' | 'Purchase Service Provider' | 'Patient' | 'Responsible Party' | 'Policyholder' | 'Physician' | 'Managed Care' | 'Chiropractor' | 'Dentist' | 'Doctor of Osteopathy' | 'Podiatrist' | 'Group Practice' | 'Medical Doctor' | 'Receiving Location' | 'Rural Health Clinic' | 'Skilled Nursing Facility' | 'Secondary Payer' | 'Service Provider' | 'Supplier/Manufacturer' | 'Transfer Point' | 'Testing Laboratory' | 'Third Party Reviewing Organization (TPO)' | 'Transfer To' | 'Tertiary Payer' | 'Third Party Repricing Organization (TPO)' | 'Nursing Home' | 'Utilization Management Organization' | 'Spouse' | 'Durable Medical Equipment Supplier' | 'Mutually Defined' — Entity descriptions corresponding to Entity Identifier codes.
      - `entityCode` '1E' | '1G' | '1H' | '1I' | '1O' | '1P' | '1Q' | '1R' | '1S' | '1T' | '1U' | '1V' | '1W' | '1X' | '1Y' | '1Z' | '2A' | '2B' | '2D' | '2E' | '2I' | '2K' | '2P' | '2Q' | '2S' | '2Z' | '03' | '3A' | '3C' | '3D' | '3E' | '3F' | '3G' | '3H' | '3I' | '3J' | '3K' | '3L' | '3M' | '3N' | '3O' | '3P' | '3Q' | '3R' | '3S' | '3T' | '3U' | '3V' | '3W' | '3X' | '3Y' | '3Z' | '4A' | '4B' | '4C' | '4D' | '4E' | '4F' | '4G' | '4H' | '4I' | '4J' | '4L' | '4M' | '4N' | '4O' | '4P' | '4Q' | '4R' | '4S' | '4U' | '4V' | '4W' | '4X' | '4Y' | '4Z' | '5A' | '5B' | '5C' | '5D' | '5E' | '5F' | '5G' | '5H' | '5I' | '5J' | '5K' | '5L' | '5M' | '5N' | '5O' | '5P' | '5Q' | '5R' | '5S' | '5T' | '5U' | '5V' | '5W' | '5X' | '5Y' | '5Z' | '6A' | '6B' | '6C' | '6D' | '6E' | '6F' | '6G' | '6H' | '6I' | '6J' | '6K' | '6L' | '6M' | '6N' | '6O' | '6P' | '6Q' | '6R' | '6S' | '6U' | '6V' | '6W' | '6X' | '6Y' | '7C' | '13' | '17' | '28' | '30' | '36' | '40' | '43' | '44' | '61' | '71' | '72' | '73' | '74' | '77' | '80' | '82' | '84' | '85' | '87' | '95' | 'CK' | 'CZ' | 'D2' | 'DD' | 'DJ' | 'DK' | 'DN' | 'DO' | 'DQ' | 'E1' | 'E2' | 'E7' | 'E9' | 'FA' | 'FD' | 'FE' | 'G0' | 'G3' | 'GB' | 'GD' | 'GI' | 'GJ' | 'GK' | 'GM' | 'GY' | 'HF' | 'HH' | 'I3' | 'IJ' | 'IL' | 'IN' | 'LI' | 'LR' | 'MR' | 'MSC' | 'OB' | 'OD' | 'OX' | 'P0' | 'P2' | 'P3' | 'P4' | 'P6' | 'P7' | 'PRP' | 'PT' | 'PV' | 'PW' | 'QA' | 'QB' | 'QC' | 'QD' | 'QE' | 'QH' | 'QK' | 'QL' | 'QN' | 'QO' | 'QS' | 'QV' | 'QY' | 'RC' | 'RW' | 'S4' | 'SEP' | 'SJ' | 'SU' | 'T4' | 'TL' | 'TQ' | 'TT' | 'TTP' | 'TU' | 'UH' | 'X3' | 'X4' | 'X5' | 'ZZ' — Entity Identifier codes used to identify organizational entities, physical locations, properties, or individuals.
      - `paidDate` string — This is the date of denial or approval for the claim. This date may or may not be the same as the issue date of the check, EFT, or non-payment remittance. Some payers can provide this date before they issue the remittance. This value is returned in ISO 8601 date format (YYYY-MM-DD). For example: 2026-03-04.
      - `patientAccountNumber` string — The patient account number provided by the service provider in the original claim. You can use this value to correlate the claim status response to the original claim.
      - `statusCategoryCode` string — The status category code. Visit [Claim Status Category Codes](https://x12.org/codes/claim-status-category-codes) in the official X12 documentation for a complete list.
      - `statusCategoryCodeValue` string — The description of the `statusCategoryCode`.
      - `statusCode` string — The status code used to identify the status of an entire claim or a service line. For example, `20` - Accepted for Processing. This is either a Health Care Claim Status Code or a National Council for Prescription Drug Programs (NCPDP) Reject/Payment Code, when the status is related to pharmacy claims. Visit [Claim Status Codes]([Health Care Claim Status Code](https://x12.org/codes/claim-status-codes) in the official X12 documentation or the [NCPDP website](https://ncpdp.org/) for a complete list of codes and their values.
      - `statusCodeValue` string — The description of the `statusCode`.
      - `submittedAmount` string — The total charges submitted for the claim. The total claim charge may change from the submitted claim total charge based on claims processing instructions, such as claim splitting. Some payers may not store the original submitted charge. Some HMO encounters supply zero as the amount of original charges.
      - `trackingNumber` string — This is the trace or reference number of the original claim status request.
      - `tradingPartnerClaimNumber` string — An identifier for the claim, assigned by the payer.
    - `serviceDetails` ServiceDetail[] — Information about specific service lines and their status. Payers may not return service line details for all claims, even when you requested them.
      - `service` Service — Information about a service line listed in the referenced claim.
        - `amountPaid` string — The amount paid for the service line, expressed as a decimal. For example, `100.00`.
        - `procedureId` string — Identifying number for product or service.
        - `procedureModifiers` string[] — Procedure modifier codes that provide additional information about the service performed.
        - `revenueCode` string — The National Uniform Billing Committee revenue code.
        - `serviceIdQualifier` string — The definition of the `serviceIdQualifierCode`. For example, `American Dental Association Codes`.
        - `serviceIdQualifierCode` 'AD' | 'ER' | 'HC' | 'HP' | 'IV' | 'N4' | 'NU' | 'WK' — A code identifying the type/source of the `procedureId`. Visit [Claims code lists](https://www.stedi.com/docs/healthcare/claims-code-lists#product-or-service-id-qualifier) for a complete list.
        - `submittedAmount` string — The amount submitted for the service line, expressed as a decimal. For example, `100.00`. This is the line item total on the current claim service status.
        - `submittedUnits` string — The number of units of service submitted.
      - `status` Status[] — Information about the status, required action, and paid information of a service line.
        - `effectiveDate` string — The date the service line was placed in this status by the payer's adjudication process. This value is returned in ISO 8601 date format (YYYY-MM-DD). For example: 2026-03-04.
        - `entity` 'Health Maintenance Organization (HMO)' | 'Oncology Center' | 'Kidney Dialysis Unit' | 'Preferred Provider Organization (PPO)' | 'Acute Care Hospital' | 'Provider' | 'Military Facility' | 'University, College or School' | 'Outpatient Surgicenter' | 'Physician, Clinic or Group Practice' | 'Long Term Care Facility' | 'Extended Care Facility' | 'Psychiatric Health Facility' | 'Laboratory' | 'Retail Pharmacy' | 'Home Health Care' | 'Federal, State, County or City Facility' | 'Third-Party Administrator' | 'Miscellaneous Health Care Facility' | 'Non-Health Care Miscellaneous Facility' | 'Church Operated Facility' | 'Partnership' | 'Public Health Service Facility' | 'Veterans Administration Facility' | 'Public Health Service Indian Service Facility' | 'Hospital Unit of an Institution (prison hospital, college infirmary, etc.)' | 'Dependent' | 'Hospital Unit Within an Institution for the Mentally Retarded' | 'Tuberculosis and Other Respiratory Diseases Facility' | 'Obstetrics and Gynecology Facility' | 'Eye, Ear, Nose and Throat Facility' | 'Rehabilitation Facility' | 'Orthopedic Facility' | 'Chronic Disease Facility' | 'Other Specialty Facility' | 'Children's General Facility' | 'Children's Hospital Unit of an Institution' | 'Children's Psychiatric Facility' | 'Children's Tuberculosis and Other Respiratory Diseases Facility' | 'Children's Eye, Ear, Nose and Throat Facility' | 'Children's Rehabilitation Facility' | 'Children's Orthopedic Facility' | 'Children's Chronic Disease Facility' | 'Children's Other Specialty Facility' | 'Institution for Mental Retardation' | 'Alcoholism and Other Chemical Dependency Facility' | 'General Inpatient Care for AIDS/ARC Facility' | 'AIDS/ARC Unit' | 'Specialized Outpatient Program for AIDS/ARC' | 'Alcohol/Drug Abuse or Dependency Inpatient Unit' | 'Alcohol/Drug Abuse or Dependency Outpatient Services' | 'Arthritis Treatment Center' | 'Birthing Room/LDRP Room' | 'Burn Care Unit' | 'Cardiac Catherization Laboratory' | 'Open-Heart Surgery Facility' | 'Cardiac Intensive Care Unit' | 'Angioplasty Facility' | 'Chronic Obstructive Pulmonary Disease Service Facility' | 'Emergency Department' | 'Trauma Center (Certified)' | 'Extracorporeal Shock-Wave Lithotripter (ESWL) Unit' | 'Genetic Counseling/Screening Services' | 'Adult Day Care Program Facility' | 'Alzheimer's Diagnostic/Assessment Services' | 'Comprehensive Geriatric Assessment Facility' | 'Emergency Response (Geriatric) Unit' | 'Geriatric Acute Care Unit' | 'Geriatric Clinics' | 'Respite Care Facility' | 'Patient Education Unit' | 'Community Health Promotion Facility' | 'Worksite Health Promotion Facility' | 'Hemodialysis Facility' | 'Home Health Services' | 'Hospice' | 'Medical Surgical or Other Intensive Care Unit' | 'Histopathology Laboratory' | 'Blood Bank' | 'Neonatal Intensive Care Unit' | 'Obstetrics Unit' | 'Occupational Health Services' | 'Organized Outpatient Services' | 'Pediatric Acute Inpatient Unit' | 'Psychiatric Child/Adolescent Services' | 'Psychiatric Consultation-Liaison Services' | 'Psychiatric Education Services' | 'Psychiatric Emergency Services' | 'Psychiatric Geriatric Services' | 'Psychiatric Inpatient Unit' | 'Psychiatric Outpatient Services' | 'Psychiatric Partial Hospitalization Program' | 'Megavoltage Radiation Therapy Unit' | 'Radioactive Implants Unit' | 'Therapeutic Radioisotope Facility' | 'X-Ray Radiation Therapy Unit' | 'CT Scanner Unit' | 'Diagnostic Radioisotope Facility' | 'Magnetic Resonance Imaging (MRI) Facility' | 'Ultrasound Unit' | 'Rehabilitation Inpatient Unit' | 'Rehabilitation Outpatient Services' | 'Reproductive Health Services' | 'Skilled Nursing or Other Long-Term Care Unit' | 'Single Photon Emission Computerized Tomography (SPECT) Unit' | 'Organized Social Work Service Facility' | 'Outpatient Social Work Services' | 'Emergency Department Social Work Services' | 'Sports Medicine Clinic/Services' | 'Hospital Auxiliary Unit' | 'Patient Representative Services' | 'Volunteer Services Department' | 'Outpatient Surgery Services' | 'Organ/Tissue Transplant Unit' | 'Orthopedic Surgery Facility' | 'Occupational Therapy Services' | 'Physical Therapy Services' | 'Recreational Therapy Services' | 'Respiratory Therapy Services' | 'Speech Therapy Services' | 'Women's Health Center/Services' | 'Cardiac Rehabilitation Program Facility' | 'Non-Invasive Cardiac Assessment Services' | 'Emergency Medical Technician' | 'Disciplinary Contact' | 'Case Manager' | 'Place of Occurrence' | 'Contracted Service Provider' | 'Consultant's Office' | 'Subcontractor' | 'Service Supplier' | 'Employer' | 'Receiver' | 'Claimant Authorized Representative' | 'Data Processing Service Bureau' | 'Performed At' | 'Attending Physician' | 'Operating Physician' | 'Other Physician' | 'Corrected Insured' | 'Service Location' | 'Hospital' | 'Rendering Provider' | 'Subscriber's Employer' | 'Billing Provider' | 'Pay-to Provider' | 'Research Institute' | 'Pharmacist' | 'Admitting Surgeon' | 'Commercial Insurer' | 'Assistant Surgeon' | 'Consulting Physician' | 'Ordering Physician' | 'Referring Provider' | 'Dependent Name' | 'Supervising Physician' | 'Person or Other Entity Legally Responsible for a Child' | 'Person or Other Entity With Whom a Child Resides' | 'Previous Employer' | 'Participating Laboratory' | 'Facility' | 'Physical Address' | 'Mail Address' | 'Dependent Insured' | 'Clinic' | 'Other Insured' | 'Guardian' | 'Paramedic' | 'Paramedical Company' | 'Previous Insured' | 'Spouse Insured' | 'Treatment Facility' | 'Healthcare Professional Shortage Area (HPSA) Facility' | 'Home Health Agency' | 'Independent Physicians Association (IPA)' | 'Injection Point' | 'Insured or Subscriber' | 'Insurer' | 'Independent Lab' | 'Legal Representative' | 'Medical Insurance Carrier' | 'Mammography Screening Center' | 'Ordered By' | 'Doctor of Optometry' | 'Oxygen Therapy Facility' | 'Patient Facility' | 'Primary Insured or Subscriber' | 'Primary Care Provider' | 'Prior Insurance Carrier' | 'Third Party Reviewing Preferred Provider Organization (PPO)' | 'Third Party Repricing Preferred Provider Organization (PPO)' | 'Primary Payer' | 'Party to Receive Test Report' | 'Party performing certification' | 'Pickup Address' | 'Pharmacy' | 'Purchase Service Provider' | 'Patient' | 'Responsible Party' | 'Policyholder' | 'Physician' | 'Managed Care' | 'Chiropractor' | 'Dentist' | 'Doctor of Osteopathy' | 'Podiatrist' | 'Group Practice' | 'Medical Doctor' | 'Receiving Location' | 'Rural Health Clinic' | 'Skilled Nursing Facility' | 'Secondary Payer' | 'Service Provider' | 'Supplier/Manufacturer' | 'Transfer Point' | 'Testing Laboratory' | 'Third Party Reviewing Organization (TPO)' | 'Transfer To' | 'Tertiary Payer' | 'Third Party Repricing Organization (TPO)' | 'Nursing Home' | 'Utilization Management Organization' | 'Spouse' | 'Durable Medical Equipment Supplier' | 'Mutually Defined' — Entity descriptions corresponding to Entity Identifier codes.
        - `entityCode` '1E' | '1G' | '1H' | '1I' | '1O' | '1P' | '1Q' | '1R' | '1S' | '1T' | '1U' | '1V' | '1W' | '1X' | '1Y' | '1Z' | '2A' | '2B' | '2D' | '2E' | '2I' | '2K' | '2P' | '2Q' | '2S' | '2Z' | '03' | '3A' | '3C' | '3D' | '3E' | '3F' | '3G' | '3H' | '3I' | '3J' | '3K' | '3L' | '3M' | '3N' | '3O' | '3P' | '3Q' | '3R' | '3S' | '3T' | '3U' | '3V' | '3W' | '3X' | '3Y' | '3Z' | '4A' | '4B' | '4C' | '4D' | '4E' | '4F' | '4G' | '4H' | '4I' | '4J' | '4L' | '4M' | '4N' | '4O' | '4P' | '4Q' | '4R' | '4S' | '4U' | '4V' | '4W' | '4X' | '4Y' | '4Z' | '5A' | '5B' | '5C' | '5D' | '5E' | '5F' | '5G' | '5H' | '5I' | '5J' | '5K' | '5L' | '5M' | '5N' | '5O' | '5P' | '5Q' | '5R' | '5S' | '5T' | '5U' | '5V' | '5W' | '5X' | '5Y' | '5Z' | '6A' | '6B' | '6C' | '6D' | '6E' | '6F' | '6G' | '6H' | '6I' | '6J' | '6K' | '6L' | '6M' | '6N' | '6O' | '6P' | '6Q' | '6R' | '6S' | '6U' | '6V' | '6W' | '6X' | '6Y' | '7C' | '13' | '17' | '28' | '30' | '36' | '40' | '43' | '44' | '61' | '71' | '72' | '73' | '74' | '77' | '80' | '82' | '84' | '85' | '87' | '95' | 'CK' | 'CZ' | 'D2' | 'DD' | 'DJ' | 'DK' | 'DN' | 'DO' | 'DQ' | 'E1' | 'E2' | 'E7' | 'E9' | 'FA' | 'FD' | 'FE' | 'G0' | 'G3' | 'GB' | 'GD' | 'GI' | 'GJ' | 'GK' | 'GM' | 'GY' | 'HF' | 'HH' | 'I3' | 'IJ' | 'IL' | 'IN' | 'LI' | 'LR' | 'MR' | 'MSC' | 'OB' | 'OD' | 'OX' | 'P0' | 'P2' | 'P3' | 'P4' | 'P6' | 'P7' | 'PRP' | 'PT' | 'PV' | 'PW' | 'QA' | 'QB' | 'QC' | 'QD' | 'QE' | 'QH' | 'QK' | 'QL' | 'QN' | 'QO' | 'QS' | 'QV' | 'QY' | 'RC' | 'RW' | 'S4' | 'SEP' | 'SJ' | 'SU' | 'T4' | 'TL' | 'TQ' | 'TT' | 'TTP' | 'TU' | 'UH' | 'X3' | 'X4' | 'X5' | 'ZZ' — Entity Identifier codes used to identify organizational entities, physical locations, properties, or individuals.
        - `statusCategoryCode` string — The category code for the status. Visit [Claim Status Category Codes](https://x12.org/codes/claim-status-category-codes) in the official X12 documentation for a complete list.
        - `statusCategoryCodeValue` string — The description of the `statusCategoryCode`.
        - `statusCode` string — The status code used to identify the status of an entire service line. This is either a [Health Care Claim Status Code](https://x12.org/codes/claim-status-codes) or a National Council for Prescription Drug Programs Reject/Payment Code, when the status is related to pharmacy claims.
        - `statusCodeValue` string — The description of the `statusCode`.
  - `controlNumber` string — The control number the payer provided in the claim status response. This is used to identify the transaction.
  - `dependent` Member
    - `dateOfBirth` string — The dependent's date of birth.
    - `firstName` string, required — The dependent's first name as specified on their insurance policy.
    - `gender` 'M' | 'F' — A code indicating the dependent's gender. If the claim set the dependent's gender to `U` for unknown, you should omit this property from the claim status request.
    - `groupNumber` string — The group number associated with the subscriber and dependent's insurance policy.
    - `lastName` string, required — The dependent's last name as specified on their insurance policy.
    - `suffix` string — The dependent's name suffix, such as Sr. or III. Only include the dependent's personal name suffix - **don't** include professional or academic titles, such as M.D. or MBA.
  - `errorResponse` ErrorResponse
    - `code` string
    - `description` string
    - `errors` ErrorDetail[]
      - `code` string — The error code.
      - `description` string — The description of the error code.
      - `field` string — The attribute that caused the error.
      - `followupAction` string — Follow-up actions to correct the error.
      - `location` string — Where the error occurred within the request syntax. If this is a network or system error, there is no location attribute.
      - `value` string — The value that caused the error.
    - `transactionIdentifier` TransactionIdentifier
      - `customerTransactionId` string
      - `transactionId` string
  - `implementationTransactionSetSyntaxError` string — The syntax error code in the 999 Implementation Acknowledgment. It indicates the type of error (if present) in the EDI request syntax. Visit `IK502` in the [Implementation Acknowledgment specification](https://portal.stedi.com/app/guides/view/hipaa/implementation-acknowledgment-x231/01HRF41ES1DVGCA6X1EHSRPFXZ#properties.heading.properties.transaction_set_response_header_AK2_loop.items.properties.transaction_set_response_trailer_IK5.properties.implementation_transaction_set_syntax_error_code_02) for a complete list.
  - `meta` ClaimStatusResponseMeta — Metadata about the response.
    - `applicationMode` string — Identifies 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 unique ID assigned to this request within Stedi.
  - `payer` ClaimStatusPayer — Information about the payer listed in the referenced claim.
    - `centersForMedicareAndMedicaidServicePlanId` string — The payer's Health Plan ID (HPID) or Other Entity Identifier (OEID).
    - `contactInformation` ClaimStatusContactInformation
      - `electronicDataInterChangeAccessNumber` string — The payer's Electronic Data Interchange Access number.
      - `email` string — The payer's email address.
      - `fax` string — The payer's fax number, without separators. For example, `5551123345` for `555-112-3345`
      - `name` string — The payer contact name.
      - `phone` string — The payer's telephone number. Phone numbers are formatted as AAABBBCCCC, where AAA represents the area code, BBB represents the telephone number prefix, and CCCC represents the telephone number. Phone numbers are provided without separators, such as dashes or parentheses. For example, `5551123345` for `555-112-3345`.
      - `phoneExtension` string — The payer's telephone extension.
    - `organizationName` string — The payer's organization name. For example `UNITEDHEALTHCARE`.
    - `payerIdentification` string — The payer's identification number. This is the `tradingPartnerServiceId`.
  - `providers` StatusResponseProvider[] — Information about the billing and/or service providers related to the referenced claim.
    - `etin` string — The Electronic Transmitter Identification Number (ETIN).
    - `firstName` string — The provider's first name.
    - `lastName` string — The provider's last name.
    - `npi` string — The [National Provider Identification (NPI)](https://www.stedi.com/docs/healthcare/national-provider-identifier) number.
    - `organizationName` string — The provider's organization name.
    - `providerType` 'BillingProvider' | 'ServiceProvider', required — Identifies the type of provider related to the referenced healthcare claim.
    - `spn` string — The service provider number.
    - `taxId` string — The Taxpayer Identification Number (TIN).
    - `tin` string
  - `reassociationKey` string — The control number for the transaction.
  - `status` string — The status of the entire claim.
  - `subscriber` ClaimStatusSubscriber — Information about the subscriber listed in the referenced claim. - You must set both the `dateOfBirth` and `gender` properties when the subscriber is the patient unless the gender is unknown. 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 unless the gender is unknown.
    - `dateOfBirth` string — The subscriber's date of birth.
    - `firstName` string, required — The subscriber's first name as specified on their policy.
    - `gender` 'M' | 'F' — A code indicating the subscriber's gender. If the claim set the subscriber's gender to `U` for unknown, you should omit this property from the claim status request.
    - `groupNumber` string — The group number associated with the subscriber's insurance policy.
    - `lastName` string, required — The subscriber's last name as specified on their policy. The subscriber can be an individual or a business entity.
    - `memberId` string, required — The subscriber's insurance member ID. This is the unique identifier for the subscriber on the insurance policy.
    - `suffix` string — The subscriber's name suffix, such as Jr., Sr., or III. Only include the subscriber's personal name suffix - **don't** include professional or academic titles, such as M.D. or MBA.
  - `tradingPartnerServiceId` string — An ID for the payer you identified in the original claim status request. 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.
  - `transactionSetAcknowledgement` string — The acknowledgment code in the 999 Implementation Acknowledgment, an EDI file generated by the payer to acknowledge receipt of the claim status request. It indicates whether the claim status request was accepted or rejected due to errors in the EDI request syntax.
  - `warnings` Warning[] — Issues with your claim status request that could affect the results, or information about the response. For example, warnings can help explain why the request was rejected.
    - `code` string — The warning code.
    - `description` string — The warning description.
  - `x12` string — The raw X12 response from the payer.

## Other responses

- `400` — ValidationException 400 response
- `403` — AccessDeniedException 403 response
- `404` — ResourceNotFoundException 404 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/c156a60615bb/schema)
