---
title: "Get provider locations"
method: GET
path: "/v1/provider_locations"
tags: ["provider-locations"]
---

# Get provider locations

`GET /v1/provider_locations`

## Request

- Base URL: `https://api-developer-sandbox.zocdoc.com`
- URL: `https://api-developer-sandbox.zocdoc.com/v1/provider_locations`
- 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`

This endpoint accepts parameters such as zip code, specialty, visit reason and accepted insurance to return a filtered set of providers within the developer's directory. The response includes additional information about the provider location objects returned.

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

## Query parameters

- `zip_code` string
- `latitude` number, float
- `longitude` number, float
- `specialty_id` string
- `visit_reason_id` string
- `page` integer
- `page_size` integer
- `insurance_plan_id` string
- `visit_type` 'all' | 'in_person' | 'video_visit': The type of patient visit with the provider.
- `max_distance_to_patient_mi` integer

## Response `200`

Succesful

- ProviderListResult
  - `request_id` string, required: Unique request identifier for tracing
  - `page` integer, required: The zero based index of the current page.
  - `page_size` integer, required: The size of the current page.
  - `total_count` integer, required: The total number of result items.
  - `next_url` string, required: A link to the next page of results; null if this is the last page of results.
  - `data` ProviderSearchResult, required
    - `search_parameters` SearchParameters, required
      - `specialty_id` string, required: The Zocdoc ID of the specialty used to search with. If no specialty was provided by the developer, this will be the specialty associated with the visit reason ID that was provided.
      - `visit_reason_id` string, required: The Zocdoc ID of the visit reason used to search with. If no visit reason was provided by the developer, this will be the default visit reason for the specialty id that was provided.
    - `provider_locations` ProviderLocation[], required
      - `provider_location_id` string, required
      - `provider_location_type` 'in_person_provider' | 'virtual_provider', 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.
      - `provider` BaseProvider, required
        - `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[]
      - `location` BaseLocationWithDistance
        - `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.
      - `virtual_location` BaseVirtualLocation
        - `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
        - `practice_id` string, required
        - `practice_name` string, required
      - `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

## Other responses

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

---

[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)