---
title: "Get Availability"
method: POST
path: "/patient/self-schedule/availability"
tags: ["provider", "calendar", "self-schedule", "public"]
---

# Get Availability

`POST /patient/self-schedule/availability`

## Headers

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

## Request body

- AvailabilityRequest
  - `assignments` AvailabilityRequestAssignment[], required
    - `serviceId` string, required
    - `providerId` string, nullable
    - `preferredProviderAssignmentIndex` integer, nullable
  - `locationId` string, required
  - `start` string, date-time, required
  - `end` string, date-time, required
  - `addonSelections` object, nullable

## Response `200`

Successful Response

- GroupedAvailability[]
  - `date` string, date-time, required
  - `morning` Availability[], required
    - `start` string, date-time, required
    - `end` string, date-time, required
    - `locationId` string, nullable
    - `assignments` AvailabilityAssignment[], required
      - `serviceId` string, required
      - `providerId` string, required
  - `afternoon` Availability[], required
    - `start` string, date-time, required
    - `end` string, date-time, required
    - `locationId` string, nullable
    - `assignments` AvailabilityAssignment[], required
      - `serviceId` string, required
      - `providerId` string, required
  - `evening` Availability[], required
    - `start` string, date-time, required
    - `end` string, date-time, required
    - `locationId` string, nullable
    - `assignments` AvailabilityAssignment[], required
      - `serviceId` string, required
      - `providerId` string, 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-service-production.skmtc.workers.dev/v1/apis/decodahealth/decoda-api/revisions/4939a65a89d2/schema)