Consumer Pricing

List Providers

Retrieve a list of providers, filtered over a search by name, NPI, provider type, or location. Additionally, filter to a list of providers with Turquoise price estimates available by a selected payer, network, or package. Results reflect provider, payer, and package combinations that Turquoise has priced services for; the list may not be comprehensive of all contacted payer networks or services that are available.

get/v3/providers

Request

  • Base URL: https://api.turquoise.health
  • URL: https://api.turquoise.health/v3/providers
  • Auth: HTTP bearer

Query parameters

namestring nullable

Case-insensitive substring match on provider name.

Example:HCA HealthONE Presbyterian St Lukes
npistring nullable

Exact NPI match.

Example:1720038946
typestring nullable

Provider type as reported in the dataset (exact match).

Example:Short Term Acute Care Hospital
package_idstring nullable

Providers with at least one price for this package.

Example:R017Z
network_idstring nullable

Providers with at least one price under this network (combined with package_id/payer_id, the same price row must match).

Example:-3776001016975145508
payer_idstring nullable

Providers priced under any of this payer's networks (combined with other relationship filters, the same price row must match).

Example:76
searchstring nullable

Semantic search over provider names. Composes with the other filters and any location mode; returns a single relevance-ordered page. 503 search_unavailable until the provider embedding index is populated.

Example:Presbyterian St Lukes hospital in Denver
min_scorenumber nullable

Minimum similarity score (0-1).

page_sizeinteger
cursorstring nullable

Opaque cursor from a previous page.next_cursor.

location.near.latnumber nullable
Example:39.746549
location.near.lngnumber nullable
Example:-104.966925
location.near.radius_minteger nullable
Example:25000
location.within.statestring nullable
Example:CO
location.within.cbsastring nullable
Example:Denver-Aurora-Centennial, CO
location.within.zip_codesstring nullable

Comma-separated ZIP codes (exact match, any-of).

Example:80218,80210
location.zipstring nullable

Resolves the ZIP to its centroid, then runs near with the default radius.

Example:80218

Response

Successful Response

object'list'
no_data_reason'no_data' | 'permission_denied'
disclosuresstring[]

Human-readable caveats about what this result does and does not imply.

Example response

{
  "items": [
    {
      "address": {
        "city": "Denver",
        "latitude": 39.746549,
        "longitude": -104.966925,
        "state": "CO",
        "zip_code": "80218"
      },
      "context": {
        "distance_m": 1738.3
      },
      "id": "5754",
      "name": "HCA HealthONE Presbyterian St Lukes",
      "npi": "1720038946",
      "object": "provider",
      "type": "Short Term Acute Care Hospital"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.