---
title: "Query available booking slots"
method: GET
path: "/v1/availability"
tags: ["Availability"]
---

# Query available booking slots

`GET /v1/availability`

## Request

- Base URL: `https://api.astrocal.dev`
- URL: `https://api.astrocal.dev/v1/availability`
- Auth: HTTP bearer

Public endpoint — no authentication required. Returns available time slots for an event type within a date range.

## Query parameters

- `event_type_id` string, uuid, required
- `start` string, required
- `end` string, required
- `timezone` string, required
- `host_id` string, uuid
- `duration` integer

## Response `200`

Available slots

- object
  - `event_type_id` string, uuid, required
  - `timezone` string, required
  - `start` string, required
  - `end` string, required
  - `slots` object[], required
    - `start_time` string, required
    - `end_time` string, required
    - `spots_remaining` integer
    - `total_capacity` integer
    - `available` boolean
    - `waitlist_available` boolean
    - `waitlist_position` integer
  - `capped` boolean
  - `waitlist_available` boolean
  - `waitlist_position` integer

## Other responses

- `400`: Bad request (invalid timezone or date range)
- `404`: Event type not found
- `422`: Validation error
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/astrocal/apis/astrocal-api.md) · [All operations](https://skmtc.dev/astrocal/apis/astrocal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/astrocal/apis/astrocal-api/revisions/3b953e19a348?raw)