Skip to main content
GET
Get practitioner location by id
Returns detailed information about a single practitioner location, identified by the id returned in the locations array of the Get practitioner by NPI number endpoint. The response includes:
  • Address: the street address, city, state, and postal code for the location
  • Geocoding: coordinates for the location’s address, when available
  • Stale affiliation risk: proprietary information about whether the practitioner is actually seeing patients at this location
  • Sources: each dataset that reports that the practitioner practices at this location, with its version and the date of the pipeline run that produced it
Geocoding data is provided in part by OpenStreetMap. © OpenStreetMap contributors, available under the Open Database License (ODbL). Additional data is derived from the U.S. Census Bureau TIGER/Line® Shapefiles (public domain), from other public sources, and from proprietary sources, such as Geocodio.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your API token.

Path Parameters

id
string<uuid>
required

The id corresponding to the practitioner location. These can be found in the locations objects within the Get practitioner by NPI number endpoint.

Query Parameters

staleAffiliationRiskVersion
string

The version of the stale affiliation risk model to use, as enumerated by GET /models. Defaults to the latest version if omitted.

Response

Expected response to a valid request

A single practitioner–location pair, including the address, our derived signals, and the sources that report it.

line1
string
required

The first line of the street address, typically the street number and name.

city
string
required

The city name.

state
string
required

The two-letter USPS abbreviation for the state or territory.

postalCode
string
required

The postal (ZIP) code, in the five digit form.

sources
object[]
required

The datasets that report that the practitioner practices at this location.

servedModels
object
required

The version of each model whose output appears in this response. Always present; a key appears only when that model was served for this request, so an absent key means that model contributed nothing to the response.

line2
string

The second line of the street address, when present, such as a suite, unit, or floor.

geocoding
object

Geocoding data for the location's address, if available.

staleAffiliationRisk
object

Stale affiliation risk data for this practitioner–location pair, if available.