---
title: "Open slots at a facility on one date"
method: GET
path: "/public/locations/{slug}/availability"
tags: ["Public"]
---

# Open slots at a facility on one date

`GET /public/locations/{slug}/availability`

## Request

- Base URL: `https://simpledock.ai/api/v1`
- URL: `https://simpledock.ai/api/v1/public/locations/{slug}/availability`
- Auth: none required

Unauthenticated. Returns the bookable start times at a facility on one calendar date for one appointment type, applying the same operating hours, minimum notice, buffers, slots-per-hour, and door capacity the booking page applies. Read-only: booking requires the booking link or an API key.

## Path parameters

- `slug` string, required

## Query parameters

- `appointmentTypeId` string, required
- `date` string, date, required

## Response `200`

Success

- object
  - `data` PublicAvailability, required: Open slots at a facility on one calendar date.
    - `slug` string, required
    - `date` string, date, required
    - `timezone` string
    - `appointmentType` object
      - `id` string
      - `name` string
      - `durationMinutes` integer
    - `slots` Slot[], required
      - `startTime` string, date-time
      - `endTime` string, date-time
      - `displayTime` string
    - `bookingUrl` string, uri

## Other responses

- `400`: Missing or malformed appointmentTypeId or date
- `404`: Unknown facility or appointment type
- `429`: Rate limited — 60 requests per minute per IP; retry after Retry-After
- `500`: Availability could not be computed — retry shortly

---

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