Trading Partners

Trading Partners API Overview

Access a list trading partners and payers accepting transactions from our APIs. Find important partner attributes, including partner identifiers, eligibility search options, and more.

Trading Partners API FAQs

What's the difference between tradingPartnerId and tradingPartnerServiceId?

tradingPartnerId is a global identifier that is used to identify trading partners and payers across APIs and services. This identifier is API-agnostic and can be used to interact with any trading partner who accepts transactions through the Developer Platform.

tradingPartnerSeviceId is an identifier specific to a an API or service, such as our Eligibility API.

Example of a trading partner, showing both the tradingPartnerId and tradingPartnerServiceId specific to our medicalEligibility API:

{
    "tradingPartnerId": "ABC1234",
    "tradingPartnerName": "Payer XYZ",
    "service": [
      {
        "serviceName": "medicalEligibility",
        "tradingPartnerServiceId": "12345"
      }
    ]
  }

Which identifier should I use?

We accept either one of these identifiers in order to accomodate customers who may be using service-specific identifiers associated with our traditional X12 network solutions.

If you're new to Change Healthcare, mapping your trading partners and payers to the tradingPartnerId is recommended; this will mean your mappings are API/service-agonstic.

If you're moving from a traditional Change Healthcare X12 network solution such as real-time eligibility, feel free to send us the tradingPartnerServiceId. Just keep in mind that this identifier may not be accepted by other APIs and services other than medicalEligibility.

Trading Partners API Errors

Coming soon.