/availability endpoint returns every time slot you are bookable in, grouped by date. Use it to build custom scheduling UIs, sync free time to external tools or validate a proposed meeting time before creating a booking. Days that contain no available slots are omitted from the response, so an empty data object means nothing is bookable in the requested range.
Endpoint
availability.read
Example request
Query parameters
string
Service slug (e.g.
discovery-call) or the full booking URL (e.g. https://tikk.chat/joeri/discovery-call). When omitted, the response reflects your general availability across all services. Supplying an unknown value returns 404. Maximum 100 characters.date
First day of the requested range in
YYYY-MM-DD format. Defaults to today. Past days never return slots regardless of what you pass here.date
Last day of the requested range in
YYYY-MM-DD format. Defaults to 7 days after from. The range is capped at 31 days. Any wider window is silently clamped, and meta.to in the response tells you the actual end date that was answered.integer
Desired slot length in minutes. Must be between
15 and 180. Defaults to 30. Slots shorter than your configured buffer or longer than the service’s maximum duration may reduce or eliminate available slots.Days with zero free slots are omitted from
data. An empty data object is not an error. It just means no slots are available in that range.The date range is capped at 31 days. If you pass a
to that is more than 31 days after from, the API silently clamps the window and reports the actual end date in meta.to. Always read meta.to rather than echoing back your own input.Response schema
object
An object whose keys are
YYYY-MM-DD dates and whose values are arrays of available slots for that day. Days with no free slots are omitted.object
Metadata describing the range and context of the response.