---
title: "Get providers by NPIs"
method: GET
path: "/v1/providers"
tags: ["providers"]
---

# Get providers by NPIs

`GET /v1/providers`

## Request

- Base URL: `https://api-developer-sandbox.zocdoc.com`
- URL: `https://api-developer-sandbox.zocdoc.com/v1/providers`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.zocdoc.com/oauth/token`
  - OAuth 2
    - Authorization code: `https://auth.zocdoc.com/authorize`
    - Token URL: `https://auth.zocdoc.com/oauth/token`

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.

## Query parameters

- `npis` string, required
- `insurance_plan_id` string
- `latitude` number, float
- `longitude` number, float

## Response `200`

Successful

- ProviderResult: Data that will be returned upon a provider lookup.
  - `request_id` string, required: Unique request identifier for tracing
  - `data` ProvidersByNpi[], required
    - `npi` string
    - `providers` ProviderDetails[]
      - `provider_id` string: The Zocdoc provider ID
      - `npi` string
      - `first_name` string
      - `last_name` string
      - `title` string
      - `full_name` string
      - `gender_identity` string: Possible values include: Female, Male, Non-binary
      - `specialties` string[]
      - `specialty_ids` string[]
      - `default_visit_reason_id` string
      - `visit_reason_ids` string[]
      - `statement` string
      - `provider_photo_url` string: Protocol-relative URL to a provider's photo. URL will change if a new photo is uploaded. Only 1 photo URL will be given at a time. Photos should be 200-4,000 pixels. JPEG and PNG formats are accepted. Photos are reviewed at time of upload and on an annual basis.
      - `languages` string[]: Languages spoken at the practice location, might be facilitated by translators on site.
      - `profile_url` string: The URL to view the providers profile on Zocdoc.
      - `credentials` ProviderCredentials: Provider Credentials include education and certifications.
        - `certifications` string[], required
        - `education` Education, required
          - `institutions` string[]
      - `locations` Location[], required
        - `provider_location_id` string, required
        - `accepts_patient_insurance` 'accepted' | 'not_accepted' | 'insurance_not_specified', required: Whether the provider location accepts the patient's insurance
        - `first_availability_date_in_provider_local_time` string, date: The first date where provider has availability for new patients with any visit reason in provider's local time zone, formatted as YYYY-MM-DD and up to 90 days in the future.
        - `booking_requirements` BookingRequirements, required: Criteria for booking appointments, defines requirements and mandatory fields specified by Zocdoc providers
          - `required_fields` string[], required
          - `accepts_booking_requests_from` BookingRequestInsuranceSource[], required
        - `address1` string, required
        - `address2` string
        - `city` string, required
        - `state` string, required: The location's two letter state code.
        - `zip_code` string, required: The location's 5 digit zip code.
        - `latitude` number, float, required
        - `longitude` number, float, required
        - `location_name` string
        - `phone_number` string: Unformatted phone number for the location. Returns null for certain API products.
        - `phone_extension` string: Unformatted extension digits for the location phone number.
        - `time_zone` string: IANA time zone identifier for the location, e.g., America/New_York.
        - `distance_to_patient_mi` number, float: Distance from patient to provider in miles.
        - `is_nearest_match` boolean: True for the location closest to the provided latitude/longitude. Only populated when latitude and longitude query parameters are provided.
      - `virtual_locations` VirtualLocation[], required
        - `provider_location_id` string, required
        - `accepts_patient_insurance` 'accepted' | 'not_accepted' | 'insurance_not_specified', required: Whether the provider location accepts the patient's insurance
        - `first_availability_date_in_provider_local_time` string, date: The first date where provider has availability for new patients with any visit reason in provider's local time zone, formatted as YYYY-MM-DD and up to 90 days in the future.
        - `booking_requirements` BookingRequirements, required: Criteria for booking appointments, defines requirements and mandatory fields specified by Zocdoc providers
          - `required_fields` string[], required
          - `accepts_booking_requests_from` BookingRequestInsuranceSource[], required
        - `state` string, required: The location's two letter state code.
        - `location_name` string
        - `time_zone` string: IANA time zone identifier for the location, e.g., America/New_York.
      - `practice` Practice, required
        - `practice_id` string, required
        - `practice_name` string, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api.md) - [All operations](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api/revisions/965a6ca4ed12?raw)