---
title: "Get Appointments By Provider"
method: GET
path: "/appointment-dashboard/by-provider"
tags: ["provider", "appointment-dashboard"]
---

# Get Appointments By Provider

`GET /appointment-dashboard/by-provider`

## Request

- Base URL: `https://docs.decodahealth.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.decodahealth.com/appointment-dashboard/by-provider`
- Auth: none declared. Required headers: `TENANT`, `API-KEY`
- TypeScript: <https://skmtc.dev/decodahealth/apis/decoda-api/docs/appointment-dashboard/by-provider/get.ts> (a function with typed inputs; its response is checked against the schema)

Get count of appointments grouped by provider

## Query parameters

- `start_date` string, date, nullable
- `end_date` string, date, nullable
- `timezone` string, required
- `provider_ids` string, nullable
- `location_ids` string, nullable

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Response `200`

Successful Response

- AppointmentsByProvider[]
  - `provider` UserTiny, required
    - `id` string, required: The unique identifier for the user.
    - `firstName` string, nullable: The user's first name.
    - `lastName` string, nullable: The user's last name.
    - `phoneNumber` string, nullable: The user's phone number.
    - `email` string, nullable: The user's email address.
    - `type` 'PROVIDER' | 'PATIENT' | 'ASSISTANT', required
    - `locationId` string, nullable: The location of the user.
  - `count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) - [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) - [OpenAPI document](https://skmtc.dev/decodahealth/apis/decoda-api/revisions/4ab18c80f9e9?raw)