Claim Status API V2 Getting Started

Track down your submitted medical claims with Change Healthcare's Claims Status API!

Claim Status API v2 API

Medical claims are bills that healthcare providers submit to the patient's insurance provider. Claim billings contain specialized insurance codes that describe the care a patient receives from the provider. Our APIs help automate and manage the process of submitting and monitoring the status of submitted claims. The Claim Status v2 API checks to verify the current status of any claim you submit to insurance payers that are supported by our Change Healthcare payer lists.

The Change Healthcare Claims Status API translates the standard X12 EDI 276 transaction to the more-readable Javascript Object Notation (JSON), so it is more accessible to developers and more easily integrated into users’ applications. Our API also translates the 277 Claim Status Response body from its originating EDI to the more-understandable JSON.

The submitter uses a Claim Status request to ask about the status of a previously submitted claim. The payer returns the response, as an X12 EDI 277 transaction, which is translated back to JSON by the API gateway. It describes where the claim is in the adjudication process (for example, Pending, or Finalized).

Claim Status' main task is to check the status of a claim in the payer’s system. When the claim adjudication is complete, the response provides the result of the claim (for example, Paid, or Denied). For denied or rejected outcomes, the response includes the reasons for the denial.

If a provider has not received a payer report on a claim, or if they have not received payment, they run a claim status request to find out the most recent status of that claim. You may also need to check your Change Healthcare mailbox on a regular basis. The Claim Status API does not do this.

If you want another tool for managing Claims reports, see our Claims Responses & Reports API `/claimstatus/v2/. Thank you for choosing Change Healthcare!



Claim Reports and Responses is a complementary API to Claim Status that performs an associated but different task. It is a fetching tool for claims information from your mailbox. The Claim Status API gives you the current status of your claim but does not download the contents of your payer's claim report. For more information, see Claims Responses and Reports.



The JSON attributes in our APIs use snake-case, with the first letter of the attribute in lower case as in tradingPartnerServiceId. Our APIs are case-sensitive and your JSON request body must observe this convention.

Eligibility endpoints components

The Claims Status v2 endpoints consist of the following:



Request Method


Bearer Token


API endpoint


Raw-X12 endpoint


API Healthcheck


Operation Mode

Real-time, one request





APIs components

API Components


Content-Type Header

Always defaults to application/json

Authorization Header

Pass the Bearer authorization token to authorization header

grant_type Field

Always client_credentials

Sandbox endpoint

Production endpoint



  • If you only plan to use a few daily transactions, you can use our ConnectCenter for your Medical Network transaction needs.
    It provides most of the features supported by an API console but only allows manual entry for all data needed for a transaction. It contains Change Healthcare’s Payer Lists, the Payer List Enrollments wizard, and other API customer resources.
  • For providers sending hundreds of daily requests, we recommend using our APIs to be able to automate the submission processes and have a better fit for your business needs.

Did this page help you?