---
title: "Aggregated group availability for a meeting (symmetric heat-map)"
method: POST
path: "/api/meetings/{id}/availability"
---

# Aggregated group availability for a meeting (symmetric heat-map)

`POST /api/meetings/{id}/availability`

## Request

- Base URL: `https://whenmeet.me`
- URL: `https://whenmeet.me/api/meetings/{id}/availability`
- Auth: none declared

Returns per-30-min-slot counts of how many participants are free plus ranked slots (per-participant timezones, buffer + soonness scoring; allFree:true everyone-free slots and allFree:false compromise slots). Individual busy blocks are never exposed to link holders. Hand-marked slots count as the meeting host sees them (including what guests marked through the host’s own ask-links). A booking-link meeting answers only its organizer (404 for everyone else). `to` must be at most 60 days from now (400 bad_window).

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `from` integer, required
  - `to` integer, required
  - `durationMin` 15 | 30 | 45 | 60
  - `tz` string

## Response `200`

total, cells[{start, free}], slots[] (aggregate only — no participant list). Slots ranked over the first 90 days of the window.

## Other responses

- `404`: Unknown id, or a booking-link meeting and the caller is not its organizer.
- `409`: host_has_no_connection.

---

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