For the complete documentation index, see llms.txt.

GET /v1/availability/next

Get Next Available Slot

Get the next available time slot for a business. **Use Case**: Quick availability check - "When is the next opening?" Requires authentication and the same access to the principal as `GET /v1/availability/slots`, including its publishable-key limit. Otherwise returns `403`.

Auth required: Yes

Parameters

• business_id (query, string) — Business UUID. Also accepted as `principal_id` (alias).
• principal_id (query, string) — Alias for `business_id`. Send either (at least one required).
• duration_minutes (query, integer) — Meeting duration in minutes. Defaults to 30.
• after (query, string) — Find slots after this time (ISO 8601). Defaults to now.
• days_ahead (query, integer) — Number of days ahead to search
• timezone (query, string) — Timezone for results (IANA format)
• slot_interval (query, integer) — Candidate slot cadence in minutes. Defaults to `min(duration_minutes, 15)`.

Responses

• 200: Next available slot or no-availability response
• 400: Validation error
• 401: Authentication required or invalid
• 403: Authenticated but insufficient permissions
• 404: Resource not found
• 429: Rate limit exceeded

Authentication

Requires authentication. Pass a Bearer token (Supabase JWT) or an API key (`Authorization: Bearer vennio_sk_live_*`) in the request headers.

Base URL: https://api.vennio.app