---
title: "Get facilities"
method: GET
path: "/v1-beta/facilities"
tags: ["facilities"]
---

# Get facilities

`GET /v1-beta/facilities`

## Request

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

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

## Query parameters

- `npis` string
- `zip_code` string
- `building_type` 'clinic' | 'hospital': The type of facility building, which can be clinic or hospital.
- `page` integer
- `page_size` integer
- `visit_reason_id` string
- `insurance_plan_id` string
- `max_distance_to_patient_mi` integer

## Response `200`

Successful

- FacilitiesResponse
  - `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` Facility[], required
    - `facility_id` string, required: Zocdoc id for facility
    - `name` string, required
    - `npi` string
    - `building_type` string
    - `specialties` string[], required
    - `languages` string[], required
    - `visit_reason_ids` string[], required
    - `default_visit_reason_id` string
    - `location` BaseLocation, required
      - `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.
    - `schedule` FacilitySchedule, required
      - `schedule_id` string, required: Zocdoc id for bookable schedule
      - `provider_location_id` string, required: Zocdoc provider location id for availability and booking requests
      - `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
    - `practice` Practice
      - `practice_id` string, required
      - `practice_name` string, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found

---

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