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

# Get specialties

`GET /v1/specialties`

## Request

- Base URL: `https://api-developer-sandbox.zocdoc.com`
- URL: `https://api-developer-sandbox.zocdoc.com/v1/specialties`
- 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 specialties with optional filtering by care category

## Query parameters

- `page` integer
- `page_size` integer
- `care_category` 'health' | 'dental' | 'vision': The category of care for an insurance plan * Health: Health and Mental Health Care * Dental: Dental Care * Vision: Vision Care

## Response `200`

Success

- SpecialtiesResponse
  - `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` SpecialtyData[], required
    - `id` string, required: Zocdoc specialty id
    - `name` string, required
    - `care_category` 'health' | 'dental' | 'vision', required: The category of care for an insurance plan * Health: Health and Mental Health Care * Dental: Dental Care * Vision: Vision Care
    - `default_visit_reason_id` string, required
    - `default_visit_reason_name` string, required

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