# 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.

Endpoint: GET /v1/providers
Version: 1.177
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. Use the Get Insurance Plans endpoint to retrieve available plans.
    Example: "ip_2224"

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

  - `longitude` (number)
    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 200 fields (application/json):

  - `request_id` (string, required)
    Unique request identifier for tracing

  - `data` (array, required)

  - `data.npi` (string)

  - `data.providers` (array)

  - `data.providers.provider_id` (string)
    The Zocdoc provider ID

  - `data.providers.npi` (string)

  - `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)
    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.
    Example: "//d2uur722ua7fvv.cloudfront.net/ZeeFace_02.svg"

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

  - `data.providers.profile_url` (string)
    The URL to view the providers profile on Zocdoc.
    Example: "https://zocdoc.com/doctor/capivarudo-nojeira-md-517507?utm_source=FakeSource"

  - `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.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.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.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.locations.phone_number` (string)
    Unformatted phone number for the location. Returns null for certain API products.
    Example: "9999999999"

  - `data.providers.locations.phone_extension` (string)
    Unformatted extension digits for the location phone number.
    Example: "123"

  - `data.providers.locations.time_zone` (string)
    IANA time zone identifier for the location, e.g., America/New_York.
    Example: "America/New_York"

  - `data.providers.locations.distance_to_patient_mi` (number)
    Distance from patient to provider in miles.

  - `data.providers.locations.is_nearest_match` (boolean)
    True for the location closest to the provided latitude/longitude. Only populated when latitude and longitude query parameters are provided.

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

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

  - `data.providers.virtual_locations.accepts_patient_insurance` (string, required)
    Whether the provider location accepts the patient's insurance
    Enum: same as `data.providers.locations.accepts_patient_insurance` (3 values)

  - `data.providers.virtual_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.virtual_locations.booking_requirements` (object, required)
    Criteria for booking appointments, defines requirements and mandatory fields specified by Zocdoc providers

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

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

  - `data.providers.virtual_locations.time_zone` (string)
    IANA time zone identifier for the location, e.g., America/New_York.
    Example: "America/New_York"

  - `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)
    Unique request identifier for tracing

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

  - `errors` (array, required)

  - `errors.field` (string)

  - `errors.message` (string, required)


## Response 401 fields

## Response 403 fields