---
title: "Get visit reasons"
method: GET
path: "/v1/visit_reasons"
tags: ["visit-reasons"]
---

# Get visit reasons

`GET /v1/visit_reasons`

## Request

- Base URL: `https://api-developer-sandbox.zocdoc.com`
- URL: `https://api-developer-sandbox.zocdoc.com/v1/visit_reasons`
- 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 visit reasons with optional filtering by specialty

## Query parameters

- `page` integer
- `page_size` integer
- `specialty_id` string

## Response `200`

Success

- VisitReasonsResponse
  - `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` VisitReasonData[], required
    - `id` string, required: Zocdoc visit reason id
    - `name` string, required
    - `specialty_id` string, required: Zocdoc specialty id this visit reason belongs to

## Other responses

- `400`: Invalid request parameters.
- `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)