# Get active provider NPIs

Retrieves the list of active provider NPIs within the developer's Zocdoc directory. The NPIs retrieved here can be used to search for providers in the /v1/providers endpoint to facilitate availability, discovery, and booking.

Developers can fetch the NPI list and cache in their system. The available NPIs do not change frequently. Pulling this data once a week and/or after known directory change events should be sufficient.


Endpoint: GET /v1/reference/npi
Version: 1.22
Security: ClientCredentialsFlow, AuthorizationCodeFlow

## Query parameters:

  - `page` (integer)
    The zero indexed page of results. A mimimum value of 0 will be accepted.

  - `page_size` (integer)
    The number of results to return per page. A mimimum value of 1 and a maximum of 60000 will be accepted.

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

  - `data.npis` (array)

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