# Get facilities

Get a set of facilities within the developer's network.

Endpoint: GET /v1-beta/facilities
Version: 1.22
Security: ClientCredentialsFlow, AuthorizationCodeFlow

## Query parameters:

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

  - `zip_code` (string)
    A 5 digit zip code that will be used as the location to find facilities near by. One of  or  is required.
    Example: 36925

  - `building_type` (string)
    The type of facility building, which can be clinic or hospital.
    Enum: "clinic", "hospital"

  - `page` (integer)
    The zero indexed page of results.

  - `page_size` (integer)
    The number of results to return per page.

  - `visit_reason_id` (string)
    The Zocdoc ID of the visit reason to search by  for. See Reference Data for options.
    Example: "pc_FRO-18leckytNKtruw5dLR"

  - `insurance_plan_id` (string)
    The Zocdoc ID of the patient's insurance plan to search by  for. See Reference Data for options.
    Example: "ip_2224"

  - `max_distance_to_patient_mi` (integer)
    The maximum distance in miles from the facility to the search location (the center point of the given ). Default is 50 miles.

## Response 200 fields (application/json):

  - `request_id` (string, required)

  - `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` (array, required)

  - `data.facility_id` (string, required)
    Zocdoc id for facility

  - `data.name` (string, required)

  - `data.npi` (string)

  - `data.building_type` (string)

  - `data.specialties` (array, required)

  - `data.languages` (array, required)

  - `data.visit_reason_ids` (array, required)

  - `data.default_visit_reason_id` (string, required)

  - `data.location` (object, required)

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

  - `data.schedule.schedule_id` (string, required)
    Zocdoc id for bookable schedule

  - `data.schedule.provider_location_id` (string, required)
    Zocdoc provider location id for availability and booking requests

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

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

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

  - `data.practice` (object)

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

  - `data.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)

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