---
title: "Find live availability"
method: POST
path: "/businesses/{businessId}/availability"
tags: ["availability"]
---

# Find live availability

`POST /businesses/{businessId}/availability`

## Request

- Base URL: `https://agentbookable.com`
- URL: `https://agentbookable.com/businesses/{businessId}/availability`
- Auth: none declared

Live slots for a service. Slots are TEMPORARY (~60 seconds, see `expiresAt`) and revalidated at booking time. Always call this immediately before `POST /bookings`. If the chosen slot is taken you receive `409 SLOT_NO_LONGER_AVAILABLE` with alternatives.

## Path parameters

- `businessId` string, required

## Request body

- object
  - `serviceId` string, required
  - `from` string, required: ISO-8601 window start
  - `to` string, required: ISO-8601 window end

## Response `200`

Live slots in the window

- AvailabilityResult
  - `businessId` string
  - `serviceId` string
  - `slots` object[]
    - `id` string: Pass as slotId to POST /bookings
    - `serviceId` string
    - `start` string: ISO-8601 with business-timezone offset
    - `end` string
    - `staffId` string, nullable
    - `fetchedAt` string
    - `expiresAt` string: Slots are temporary; book before this time or re-fetch

## Other responses

- `400`: Invalid request
- `404`: Business or service unknown
- `429`: Too many requests — slow down

---

[API](https://skmtc.dev/agentbookable/apis/agentbookable-booking-api-for-ai-agents.md) · [All operations](https://skmtc.dev/agentbookable/apis/agentbookable-booking-api-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentbookable/apis/agentbookable-booking-api-for-ai-agents/revisions/736963f5951a?raw)