# 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  returned in the response can be used to retrieve availability in the endpoint /v1/provider_locations/availability.


Endpoint: GET /v1/providers
Version: 1.22
Security: ClientCredentialsFlow, AuthorizationCodeFlow

## Query parameters:

  - `npis` (string, required)
    A comma-delimited list of Provider NPI numbers. A maximum of 50 items will be accepted at a time.
    Example: "1234567891,0123456789"

  - `insurance_plan_id` (string)
    The Zocdoc ID of the patient's insurance plan. Used to determine if provider takes patient's insurance in response. See Reference Data for options.
    Example: "ip_2224"

## Response 200 fields (application/json):

  - `request_id` (string, required)

  - `data` (array, required)

  - `data.npi` (string)

  - `data.providers` (array)

  - `data.providers.first_name` (string)

  - `data.providers.last_name` (string)

  - `data.providers.title` (string)

  - `data.providers.full_name` (string)

  - `data.providers.gender_identity` (string)
    Possible values include: Female, Male, Non-binary

  - `data.providers.specialties` (array)

  - `data.providers.specialty_ids` (array)

  - `data.providers.default_visit_reason_id` (string)

  - `data.providers.visit_reason_ids` (array)

  - `data.providers.statement` (string)

  - `data.providers.provider_photo_url` (string)
    Url to a provider's photo.
    Example: "https://d2uur722ua7fvv.cloudfront.net/ZeeFace_02.svg"

  - `data.providers.languages` (array)
    Languages spoken at the practice location, might be facilitated by translators on site. Download Languages csv.
    Example: ["English","Spanish"]

  - `data.providers.credentials` (object)
    Provider Credentials include education and certifications.

  - `data.providers.credentials.certifications` (array, required)

  - `data.providers.credentials.education` (object, required)

  - `data.providers.credentials.education.institutions` (array)

  - `data.providers.locations` (array, required)

  - `data.providers.locations.provider_location_id` (string, required)
    Example: "pr_abc123-def456_wxyz7890|lo_abc123-def456_wxyz7890"

  - `data.providers.locations.accepts_patient_insurance` (string, required)
    Whether the provider location accepts the patient's insurance
    Enum: "accepted", "not_accepted", "insurance_not_specified"

  - `data.providers.locations.booking_requirements` (object, required)
    Criteria for booking appointments, defines requirements and mandatory fields specified by Zocdoc providers

  - `data.providers.locations.booking_requirements.required_fields` (array, required)

  - `data.providers.locations.booking_requirements.accepts_booking_requests_from` (array, required)
    Enum: "in_network", "out_of_network", "self_pay"

  - `data.providers.locations.first_availability_date_in_provider_local_time` (string)
    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.

  - `data.providers.locations.address1` (string, required)

  - `data.providers.locations.address2` (string)

  - `data.providers.locations.city` (string, required)

  - `data.providers.locations.state` (string, required)
    The location's two letter state code.
    Example: "NY"

  - `data.providers.locations.zip_code` (string, required)
    The location's 5 digit zip code.

  - `data.providers.locations.latitude` (number, required)

  - `data.providers.locations.longitude` (number, required)

  - `data.providers.locations.location_name` (string)

  - `data.providers.virtual_locations` (array, required)

  - `data.providers.practice` (object, required)

  - `data.providers.practice.practice_id` (string, required)

  - `data.providers.practice.practice_name` (string, required)

## Response 400 fields (application/json):

  - `request_id` (string, required)

  - `error_type` (string, required)
    Enum: "api_error", "invalid_request"

  - `errors` (array, required)

  - `errors.field` (string)

  - `errors.message` (string, required)