For the complete documentation index, see llms.txt.

GET /v1/availability/slots

Get Available Time Slots

Get bookable time slots for a business. Supports two modes: **Public mode** (no authentication): Returns standard free/busy time slots. No event details are included. **Consent-scoped mode** (authentication + `consent_id`): Returns availability scoped by the referenced consent's permissions. The authenticated user must be the grantee on the consent. Response includes a `consent` audit trail. With `availability:read:details` scope, slots include event titles and descriptions.

Auth required: Yes

Parameters

• business_id (query, string) (required) — Business UUID to check availability for
• duration_minutes (query, integer) (required) — Meeting duration in minutes
• from (query, string) — Start of date range (ISO 8601, defaults to now)
• to (query, string) — End of date range (ISO 8601, defaults to 14 days from now)
• timezone (query, string) — Timezone for results (IANA format)
• group_by_day (query, boolean) — Group slots by date
• consent_id (query, string) — Consent UUID. When provided, authentication is required and the response is scoped by the consent's permissions. The authenticated user must be the grantee on this consent.

Responses

• 200: Available time slots
• 400: Validation error
• 401: Authentication required or invalid
• 403: Authenticated but insufficient permissions
• 404: Resource not found

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