List your free time slots
curl --request GET \
--url https://app.tikk.chat/api/v1/availability \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.tikk.chat/api/v1/availability', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.tikk.chat/api/v1/availability"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.tikk.chat/api/v1/availability",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"data": {
"2026-08-17": [
{
"start": "2026-08-17T08:00:00+00:00",
"end": "2026-08-17T08:30:00+00:00",
"label": "10:00"
},
{
"start": "2026-08-17T08:30:00+00:00",
"end": "2026-08-17T09:00:00+00:00",
"label": "10:30"
}
],
"2026-08-19": [
{
"start": "2026-08-19T12:00:00+00:00",
"end": "2026-08-19T12:30:00+00:00",
"label": "14:00"
}
]
},
"meta": {
"from": "2026-08-17",
"to": "2026-08-24",
"duration_minutes": 30,
"timezone": "Europe/Brussels",
"service": 48213
}
}{
"message": "Unauthenticated."
}{
"message": "Missing required scope.",
"scopes": [
"services.write"
]
}{
"message": "Not found."
}{
"message": "The to field must be a date after or equal to from.",
"errors": {
"to": [
"The to field must be a date after or equal to from."
]
}
}{
"message": "Too Many Attempts."
}Availability
List your free time slots
Returns the slots you’re bookable in, grouped by day, exactly as a visitor sees them on your booking page: your weekly availability, date overrides, buffers and synced calendars are all taken into account.
Days without a free slot are left out, so an empty data object means
nothing is bookable in the range.
Scope: availability.read
GET
/
availability
List your free time slots
curl --request GET \
--url https://app.tikk.chat/api/v1/availability \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.tikk.chat/api/v1/availability', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.tikk.chat/api/v1/availability"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.tikk.chat/api/v1/availability",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"data": {
"2026-08-17": [
{
"start": "2026-08-17T08:00:00+00:00",
"end": "2026-08-17T08:30:00+00:00",
"label": "10:00"
},
{
"start": "2026-08-17T08:30:00+00:00",
"end": "2026-08-17T09:00:00+00:00",
"label": "10:30"
}
],
"2026-08-19": [
{
"start": "2026-08-19T12:00:00+00:00",
"end": "2026-08-19T12:30:00+00:00",
"label": "14:00"
}
]
},
"meta": {
"from": "2026-08-17",
"to": "2026-08-24",
"duration_minutes": 30,
"timezone": "Europe/Brussels",
"service": 48213
}
}{
"message": "Unauthenticated."
}{
"message": "Missing required scope.",
"scopes": [
"services.write"
]
}{
"message": "Not found."
}{
"message": "The to field must be a date after or equal to from.",
"errors": {
"to": [
"The to field must be a date after or equal to from."
]
}
}{
"message": "Too Many Attempts."
}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.