# Get provider location by id

Get info about a provider location by provider_location_id

Endpoint: GET /v1/provider_locations/{provider_location_id}
Version: 1.182
Security: ClientCredentialsFlow, AuthorizationCodeFlow

## Security:

  - `ClientCredentialsFlow` (unknown)
    oauth2

  - `AuthorizationCodeFlow` (unknown)
    oauth2

## Path parameters:

  - `provider_location_id` (string, required)
    The Zocdoc provider location id to get details for.

## Query parameters:

  - `insurance_plan_id` (string)
    The Zocdoc ID of the patient's insurance plan. Use the [Get Insurance Plans](#operation/getInsurancePlans) endpoint to retrieve available plans.

## Response 200:

  - `200` (unknown)
    Successful

## Response 200 fields (application/json):

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

  - `data` (object)

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

  - `data.provider_location_type` (string, required)
    Enum: "in_person_provider", "virtual_provider"

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

  - `data.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.provider` (object, required)

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

  - `data.provider.npi` (string)

  - `data.provider.first_name` (string)

  - `data.provider.last_name` (string)

  - `data.provider.title` (string)

  - `data.provider.full_name` (string)

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

  - `data.provider.specialties` (array)

  - `data.provider.specialty_ids` (array)

  - `data.provider.default_visit_reason_id` (string)

  - `data.provider.visit_reason_ids` (array)

  - `data.provider.statement` (string)

  - `data.provider.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.provider.languages` (array)
    Languages spoken at the practice location, might be facilitated by translators on site.
    Example: ["English","Spanish"]

  - `data.provider.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.provider.credentials` (object)
    Provider Credentials include education and certifications.

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

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

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

  - `data.location` (object)

  - `data.location.address1` (string, required)

  - `data.location.address2` (string)

  - `data.location.city` (string, required)

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

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

  - `data.location.latitude` (number, required)

  - `data.location.longitude` (number, required)

  - `data.location.location_name` (string)

  - `data.location.phone_number` (string)
    Unformatted phone number for the location. Returns null for certain API products.
    Example: 9999999999

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

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

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

  - `data.virtual_location` (object)

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

  - `data.virtual_location.location_name` (string)

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

  - `data.practice` (object)

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

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

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

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

  - `data.booking_requirements.accepts_booking_requests_from` (array, required)

## Response 400:

  - `400` (unknown)
    Invalid request parameters.

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

  - `401` (unknown)
    Unauthorized

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 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 404:

  - `404` (unknown)
    Provider location not found

## Response 404 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)