Skip to main content
GET
List your free time slots
Pass service whenever you know which service is being booked. General availability can show slots that the chosen service doesn’t offer.
The range is capped at 31 days. Read meta.to for the last day answered rather than echoing your own to.

Authorizations

Authorization
string
header
required

An API key from Settings → API Keys (starts with tikk_sk_), or an OAuth access token for a partner app. Both carry scopes; each endpoint lists the one it needs.

Scopes

availability.read

Query Parameters

service
integer

A service id, of either type. Narrows the answer to that service's own availability, durations and buffers. Omit for your general availability. An id that isn't one of your services returns 404.

Required range: x >= 1
from
string<date>

First day of the range, YYYY-MM-DD. Defaults to today. Past days never return slots.

to
string<date>

Last day of the range, YYYY-MM-DD. Defaults to 7 days after from. The range is capped at 31 days: a later to is clamped without an error, and meta.to reports the day actually answered.

duration
integer

Slot length in minutes. Defaults to the service's shortest duration, or 30 without a service.

Required range: 15 <= x <= 180

Response

Free slots for each day in the range that has any.

data
object
required

Free slots keyed by date (YYYY-MM-DD). Days without a free slot are left out.

meta
object
required