ZOzocdoc
providers

Get providers by NPIs

Retrieves specific providers within the developer's directory by NPI search. This endpoint searches active providers that are listed on Zocdoc. It returns the provider's information (such as name, gender identity, specialty), location information and provider location IDs which can be used to look up availability and book appointments. Every developer has a designated provider directory jointly defined and onboarded in partnership with Zocdoc.

The provider_location_id returned in the response can be used to retrieve availability in the endpoint /v1/provider_locations/availability.

get/v1/providers

Request

  • Base URL
    https://api-developer-sandbox.zocdoc.com
  • Auth
    • OAuth 2
      Client credentials
      Token URL: https://auth.zocdoc.com/oauth/token
    • or OAuth 2
      Authorization code: https://auth.zocdoc.com/authorize
      Token URL: https://auth.zocdoc.com/oauth/token

Query parameters

npisstring required
Example:1234567891,0123456789

A comma-delimited list of Provider NPI numbers. A maximum of 50 items will be accepted at a time.

insurance_plan_idstring
Example:ip_31820

The Zocdoc ID of the patient's insurance plan. Used to determine if provider takes patient's insurance in response. Use the Get Insurance Plans endpoint to retrieve available plans.

latitudenumber float

Latitude of the patient's location. Must be provided together with longitude. When provided, response includes distance and nearest match for each physical location.

longitudenumber float

Longitude of the patient's location. Must be provided together with latitude. When provided, response includes distance and nearest match for each physical location.

Response

Successful

request_idstring required

Unique request identifier for tracing

Example response

{
  "data": [
    {
      "providers": [
        {
          "provider_photo_url": "//d2uur722ua7fvv.cloudfront.net/ZeeFace_02.svg",
          "languages": [
            "English",
            "Spanish"
          ],
          "profile_url": "https://zocdoc.com/doctor/capivarudo-nojeira-md-517507?utm_source=FakeSource",
          "locations": [
            {
              "provider_location_id": "pr_abc123-def456_wxyz7890|lo_abc123-def456_wxyz7890",
              "state": "NY",
              "phone_number": "9999999999",
              "phone_extension": "123",
              "time_zone": "America/New_York"
            }
          ],
          "virtual_locations": [
            {
              "provider_location_id": "pr_abc123-def456_wxyz7890|lo_abc123-def456_wxyz7890",
              "state": "NY",
              "time_zone": "America/New_York"
            }
          ]
        }
      ]
    }
  ]
}

Changes

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