Get available slots | Slotflow Docs

Get available booking slots for a human within a date range. This is the core endpoint your AI agent calls to find when a human is free.

How slot computation works:

Loads the human’s base availability rules and schedule overrides
For each day in the requested range:
- Skips the day if an all-day block override matches
- Generates candidate slots from the base schedule (working days + hours)
- Removes slots that overlap with time-specific block overrides
- Adds extra slots from open overrides (availability outside base hours)
Deduplicates overlapping slots
Filters out slots that conflict with existing confirmed bookings
Returns the remaining available slots

All times are returned in UTC. The timezone field indicates the human’s local timezone so your agent can convert for display.

Returns an empty slots array (not an error) when no availability exists in the range.

Get available booking slots for a human within a date range. This is the core endpoint your AI agent calls to find when a human is free. **How slot computation works:** 1. Loads the human's base availability rules and schedule overrides 2. For each day in the requested range: - Skips the day if an all-day block override matches - Generates candidate slots from the base schedule (working days + hours) - Removes slots that overlap with time-specific block overrides - Adds extra slots from open overrides (availability outside base hours) 3. Deduplicates overlapping slots 4. Filters out slots that conflict with existing confirmed bookings 5. Returns the remaining available slots All times are returned in **UTC**. The `timezone` field indicates the human's local timezone so your agent can convert for display. Returns an empty `slots` array (not an error) when no availability exists in the range.

Authentication

AuthorizationBearer

API key authentication. Pass your key as a Bearer token:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx

Get your API key from the Slotflow Dashboard.

API key authentication. Pass your key as a Bearer token: ``` Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx ``` Get your API key from the [Slotflow Dashboard](https://app.slotflow.dev).

Path parameters

humanIdstringRequiredformat: "uuid"

The ID of the human

Query parameters

date_fromdateRequired

Start of date range (inclusive)

date_todateRequired

End of date range (inclusive)

durationintegerRequired

Meeting duration in minutes. Must match one of the human’s configured meeting_durations.

Response

Available slots within the date range

human_idstringformat: "uuid"

durationinteger

Requested duration in minutes

timezonestring

Human’s IANA timezone (informational, for display conversion)

slotslist of objects

Available time slots, sorted by start time. Empty array if no availability.

totalinteger

Number of available slots

Errors

404

Not Found Error

422

Unprocessable Entity Error

Get available booking slots for a human within a date range. This is the core endpoint your AI agent calls to find when a human is free.

How slot computation works:

Loads the human’s base availability rules and schedule overrides
For each day in the requested range:
- Skips the day if an all-day block override matches
- Generates candidate slots from the base schedule (working days + hours)
- Removes slots that overlap with time-specific block overrides
- Adds extra slots from open overrides (availability outside base hours)
Deduplicates overlapping slots
Filters out slots that conflict with existing confirmed bookings
Returns the remaining available slots

All times are returned in UTC. The timezone field indicates the human’s local timezone so your agent can convert for display.

Returns an empty slots array (not an error) when no availability exists in the range.

1	curl -G https://api.slotflow.dev/v1/humans/humanId/slots \
2	-H "Authorization: Bearer <token>" \
3	-d date_from=2026-03-10 \
4	-d date_to=2026-03-14 \
5	-d duration=30

1	{
2	"human_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
3	"duration": 30,
4	"timezone": "America/New_York",
5	"slots": [
6	{
7	"starts_at": "2026-03-10T14:00:00.000Z",
8	"ends_at": "2026-03-10T14:30:00.000Z"
9	},
10	{
11	"starts_at": "2026-03-10T14:30:00.000Z",
12	"ends_at": "2026-03-10T15:00:00.000Z"
13	},
14	{
15	"starts_at": "2026-03-10T15:00:00.000Z",
16	"ends_at": "2026-03-10T15:30:00.000Z"
17	}
18	],
19	"total": 3
20	}