---
title: Compute available slots for a service
description: "Runs the availability pipeline for the service: schedule expansion (the service-owned schedule, or each host's personal schedule for round-robin/collective)..."
api_method: GET
api_path: "/v1/availability"
canonical_url: https://wiblo.app/docs/developers/api/availability/get-availability
last_updated: 2026-07-28T18:08:25+02:00
md_url: https://wiblo.app/docs/developers/api/availability/get-availability.md
---

# Compute available slots for a service

`GET /v1/availability`

Runs the availability pipeline for the service: schedule expansion (the service-owned schedule, or each host's personal schedule for round-robin/collective) → date-override, out-of-office and holiday subtraction (enabled public holidays for a member's holiday country block whole days, WIBLO-133) → busy times from pending/accepted bookings with the service's buffers → booking/duration limits and period windows → slot generation in the requested timezone. Round-robin unions host availability, collective intersects it; `member_id` restricts the computation to one assigned host. Slot times are UTC ISO datetimes; `date_to` defaults to `date_from`. Seated services carry `available_seats`/`total_seats` per slot. Available to any active member. Per-user rate-limited at 60/60s.

## Query parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `service_id` | `string` | Yes | Id of the service to compute availability for. |
| `member_id` | `string` | No | Restricts the computation to this assigned host; omitted computes across every assigned host. |
| `date_from` | `string` | Yes | First date of the window (`YYYY-MM-DD`), interpreted in `timezone`. |
| `date_to` | `string` | No | Last date of the window (`YYYY-MM-DD`), inclusive; omitted means a single-day lookup of `date_from`. Must be on or after `date_from`, and the inclusive range may span at most 366 dates. |
| `timezone` | `string` | No | IANA time zone the dates are interpreted in and slot times are generated for, e.g. `Europe/London`. Defaults to `"UTC"`. |

## Headers

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `X-Wiblo-Workspace` | `string` | Yes | Workspace id the call is scoped to. The actor must hold an active membership in it; a foreign or unknown id collapses onto 404 WORKSPACE_NOT_FOUND. |

## Request

**curl**

```bash
curl "https://api.wiblo.app/v1/availability?service_id=3f8a2b9c-51d4-4e0b-9c6a-7d2e8f1a4b5c&date_from=2026-08-24&timezone=Europe/London" \
  -H "Authorization: Bearer $WIBLO_TOKEN" \
  -H "X-Wiblo-Workspace: $WIBLO_WORKSPACE_ID"
```

**TypeScript**

```ts
import { createSdk, getAvailability } from "@workspace/sdk"

const sdk = createSdk({ baseUrl: "https://api.wiblo.app" })

const { data, error } = await getAvailability({
  client: sdk,
  query: { service_id: "3f8a2b9c-51d4-4e0b-9c6a-7d2e8f1a4b5c", date_from: "2026-08-24", timezone: "Europe/London" },
  headers: { "X-Wiblo-Workspace": "..." },
})
```

## Example response

```json
{
  "slots": [
    {
      "time": "2026-08-24T08:00:00.000Z",
      "available": true
    },
    {
      "time": "2026-08-24T08:30:00.000Z",
      "available": true
    },
    {
      "time": "2026-08-24T09:00:00.000Z",
      "available": true
    },
    {
      "time": "2026-08-24T09:30:00.000Z",
      "available": true
    },
    {
      "time": "2026-08-24T10:00:00.000Z",
      "available": true
    },
    {
      "time": "2026-08-24T10:30:00.000Z",
      "available": true
    },
    {
      "time": "2026-08-24T11:00:00.000Z",
      "available": true
    },
    {
      "time": "2026-08-24T13:30:00.000Z",
      "available": true
    },
    {
      "time": "2026-08-24T14:00:00.000Z",
      "available": true
    },
    {
      "time": "2026-08-24T14:30:00.000Z",
      "available": true
    },
    {
      "time": "2026-08-24T15:00:00.000Z",
      "available": true
    },
    {
      "time": "2026-08-24T15:30:00.000Z",
      "available": true
    }
  ],
  "metadata": {
    "service_id": "3f8a2b9c-51d4-4e0b-9c6a-7d2e8f1a4b5c",
    "date_from": "2026-08-24",
    "date_to": "2026-08-24",
    "timezone": "Europe/London",
    "event_length": 30,
    "slot_interval": 30
  }
}
```

## Responses

**`200`** — The computed slots plus echo metadata. Returns `AvailabilityResponse`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `slots` | `array<AvailabilitySlot>` | Yes | The bookable slots in time order; busy slots are not listed. |
| `metadata` | `object` | Yes | Echo of the query plus the resolved slot parameters. |
| `metadata.service_id` | `string` | Yes | The service the slots were computed for, echoed from the query. |
| `metadata.member_id` | `string` | No | The host filter applied; omitted when the query named no `member_id`. |
| `metadata.date_from` | `string` | Yes | First date of the computed window (`YYYY-MM-DD`), echoed from the query. |
| `metadata.date_to` | `string` | Yes | Last date of the computed window (`YYYY-MM-DD`); echoes `date_from` on single-day lookups. |
| `metadata.timezone` | `string` | Yes | The IANA time zone slots were generated in, echoed from the query. |
| `metadata.event_length` | `integer` | Yes | Appointment length in minutes, from the service. |
| `metadata.slot_interval` | `integer` | Yes | Minutes between offered start times — the service's `slot_interval`, falling back to its length. |

**`400`** — A query parameter failed validation, or the `X-Wiblo-Workspace` header was missing (`VALIDATION_FAILED`). Returns `ApiErrorEnvelope`.

**`401`** — No valid session cookie or `wbl_*` bearer was present. Returns `ApiErrorEnvelope`.

**`404`** — The workspace or service collapsed (`WORKSPACE_NOT_FOUND` / `SERVICE_NOT_FOUND` — hidden and retired services included) or `member_id` is not an assigned host (`HOST_NOT_FOUND`). Returns `ApiErrorEnvelope`.

**`422`** — The service has no assigned hosts (`SERVICE_HAS_NO_HOSTS`). Returns `ApiErrorEnvelope`.

**`429`** — Rate limit exceeded. The body's `error.code` is `RATE_LIMITED` and `error.details.retry_after` is the same number of seconds as the `Retry-After` header. Returns `ApiErrorEnvelope`.

### The AvailabilitySlot object

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `time` | `string` | Yes | Slot start as a UTC ISO datetime. |
| `available` | `boolean` | Yes | Whether the slot can be booked. Busy slots are absent from the list entirely, so non-seated slots always carry `true`; a seated slot reports `false` when no seats remain. |
| `available_seats` | `integer \| null` | No | Seats still open on the slot; omitted when the service is not seated. |
| `total_seats` | `integer \| null` | No | The service's seat capacity per slot; omitted when the service is not seated. |