---
title: "Get Shifts By Date"
method: GET
path: "/calendar/shifts/by-date"
tags: ["provider", "calendar"]
---

# Get Shifts By Date

`GET /calendar/shifts/by-date`

## 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/calendar/shifts/by-date`
- Auth: none declared. Required headers: `TENANT`, `API-KEY`
- TypeScript: <https://skmtc.dev/decodahealth/apis/decoda-api/docs/calendar/shifts/by-date/get.ts> (a function with typed inputs; its response is checked against the schema)

Get all shifts for a specific date with provider information

## Query parameters

- `date` string, required: Date in YYYY-MM-DD format

## Headers

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

## Response `200`

Successful Response

- ShiftsByDateResponse
  - `date` string, required
  - `providers` ProviderShiftsData[], required
    - `provider` ProviderTiny, required
      - `id` string, required
      - `firstName` string, required
      - `lastName` string, nullable
      - `email` string, nullable
      - `createdDate` string, date-time, nullable
    - `shifts` EventTinyOutput[], required
      - `id` string, required
      - `title` string, required
      - `start` string, date-time, required
      - `end` string, date-time, required
      - `type` 'APPOINTMENT' | 'SHIFT' | 'BLOCK', required
      - `location` LocationTiny
        - `id` string, required
        - `isVirtual` boolean, required
      - `attendees` AttendeeDetailOutput[]
        - `user` 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.
        - `inviteStatus` 'PENDING' | 'ACCEPTED' | 'REJECTED', required
      - `status` 'PENDING' | 'RESERVED' | 'CONFIRMED' | 'CANCELLED' | 'COMPLETED' | 'OVERRIDABLE' | 'NO_SHOW', required
      - `recurringEventId` string, nullable
      - `recurringEvent` RecurringEventDetail
        - `id` string, required
        - `rrule` string, required
        - `startDate` string, date-time, required
        - `durationMinutes` integer, required
        - `timezone` string, required
        - `serviceIds` string[], nullable
        - `capacity` integer, nullable
        - `type` 'APPOINTMENT' | 'SHIFT' | 'BLOCK', required
        - `title` string, required
        - `attendeeIds` string[], nullable
        - `locationId` string, nullable
        - `organizerId` string, required
      - `eventServices` EventServiceTiny[]
        - `service` ServiceTiny, required
          - `id` string, required
          - `duration` integer, required
          - `name` string, required
          - `locationIds` string[], nullable
          - `color` string, required
        - `providerId` string, nullable
        - `bookables` EventServiceBookable[], nullable
          - `eventId` string, required
          - `serviceId` string, required
          - `bookableId` string, required
          - `start` string, date-time, required
          - `end` string, date-time, required
        - `start` string, date-time, nullable
        - `end` string, date-time, nullable
        - `externalId` string, nullable
        - `isArchived` boolean, nullable
      - `icons` EventIcon[]
      - `capacity` integer, nullable
    - `appointments` EventTinyOutput[], required
      - `id` string, required
      - `title` string, required
      - `start` string, date-time, required
      - `end` string, date-time, required
      - `type` 'APPOINTMENT' | 'SHIFT' | 'BLOCK', required
      - `location` LocationTiny
        - `id` string, required
        - `isVirtual` boolean, required
      - `attendees` AttendeeDetailOutput[]
        - `user` 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.
        - `inviteStatus` 'PENDING' | 'ACCEPTED' | 'REJECTED', required
      - `status` 'PENDING' | 'RESERVED' | 'CONFIRMED' | 'CANCELLED' | 'COMPLETED' | 'OVERRIDABLE' | 'NO_SHOW', required
      - `recurringEventId` string, nullable
      - `recurringEvent` RecurringEventDetail
        - `id` string, required
        - `rrule` string, required
        - `startDate` string, date-time, required
        - `durationMinutes` integer, required
        - `timezone` string, required
        - `serviceIds` string[], nullable
        - `capacity` integer, nullable
        - `type` 'APPOINTMENT' | 'SHIFT' | 'BLOCK', required
        - `title` string, required
        - `attendeeIds` string[], nullable
        - `locationId` string, nullable
        - `organizerId` string, required
      - `eventServices` EventServiceTiny[]
        - `service` ServiceTiny, required
          - `id` string, required
          - `duration` integer, required
          - `name` string, required
          - `locationIds` string[], nullable
          - `color` string, required
        - `providerId` string, nullable
        - `bookables` EventServiceBookable[], nullable
          - `eventId` string, required
          - `serviceId` string, required
          - `bookableId` string, required
          - `start` string, date-time, required
          - `end` string, date-time, required
        - `start` string, date-time, nullable
        - `end` string, date-time, nullable
        - `externalId` string, nullable
        - `isArchived` boolean, nullable
      - `icons` EventIcon[]
      - `capacity` integer, nullable

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