---
title: "Get available time slots for an appointment type"
method: GET
path: "/api/sites/multiscreen/{site_name}/booking/availability"
tags: ["Native booking availability api"]
---

# Get available time slots for an appointment type

`GET /api/sites/multiscreen/{site_name}/booking/availability`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/sites/multiscreen/{site_name}/booking/availability`
- Auth: HTTP basic

Returns the slot map bucketed by date in the requested timezone. The agent walks the map to learn what's bookable between `start` and `end`.

## Path parameters

- `site_name` string, required

## Query parameters

- `appointment_type_id` string, required
- `start` string, required
- `end` string, required
- `time_zone` string
- `duration` integer

## Response `200`

OK

- ApiAppointmentAvailabilityResponse
  - `slots` object: Map of date string (YYYY-MM-DD in the requested timezone) to the slots open on that day.
  - `time_zone` string: Timezone the returned slots are bucketed in. Defaults to UTC when the caller did not specify time_zone.

## Other responses

- `400`: Non-OK response from the server
- `401`: Unauthorized request - missing or invalid credentials
- `429`: Rate limit exceeded - please refer to api documentation for limits

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)