getPractitioner Query Update (Effective December 1st):

The getPractitioner query will be deprecated on December 1st and will return a new response type: GetPractitionerResponse.

What Changed:

• Response type changed from Practitioner to GetPractitionerResponse
• DEA licenses use GetPractitionerDeaLicenseResponse type
• Exclusions use GetPractitionerExclusionResponse type

Migration Steps:

1. Update your GraphQL queries to use the new type definitions

Example Query:

query GetPractitioner(: GetPractitionerInput!) {
  getPractitioner(input: ) {
    id
    npi
    fullName
    licenses {
      licenseNumber
      licenseState
      primarySource {
        name
        state
        url
      }
    }
    otherPossibleLicenses {
      licenseNumber
      licenseState
    }
    deaLicenses {
      deaRegistrationNumber
      expirationDate
    }
    exclusions {
      details
      authority
      status
    }
  }
}

For questions about this breaking change, please contact our support team.

To obtain your API Token, please contact a member of our support team. They will assist you with the process and provide the necessary credentials.

Once you have received your API Token, you can access Baton's API by including the token in the "Authorization" header of your requests. The header should be formatted as follows:

Authorization: YOUR_API_TOKEN

Ensure that you replace YOUR_API_TOKEN with the actual token provided to you. This token must be included in all requests to authenticate and authorize access to the API endpoints.

If you encounter any issues or have further questions about authentication, please contact our support team for assistance.

Data Access Requirements:

DEA License Data: DEA (Drug Enforcement Administration) license information is available for practitioners who are added to your rosters. This sensitive data requires special permissions and is only accessible when:

1. The practitioner is added to one of your rosters
2. Your organization has been granted DEA data access permissions
3. You explicitly request DEA data in your GraphQL query

To access DEA data, include the deaLicenses field in your practitioner query:

query GetRosterItems(: GetRosterItemsInput!) {
  getRosterItems(input: ) {
    items {
      practitioner {
        deaLicenses {
          deaRegistrationNumber
          expirationDate
          activity
          businessActivityDescription
        }
      }
    }
  }
}

If you do not have DEA access permissions, the deaLicenses field will return an empty array.

Exclusion Data: Exclusion information is available for practitioners who are added to your rosters. This includes data from sources like SAM (System for Award Management) and OIG (Office of Inspector General). To access exclusion data, include the exclusions field in your practitioner query:

query GetRosterItems(: GetRosterItemsInput!) {
  getRosterItems(input: ) {
    items {
      practitioner {
        exclusions {
          details
          authority
          status
          effectiveDate
          matchType
          matchDetails
        }
      }
    }
  }
}

Fragment References: Anywhere the documentation notes a "Fragment", please refer to that type definition for all fields that can be included in that request.

Contact our support team if you need additional data access permissions for your organization.