curl --request GET \
--url https://app.famulor.io/api/v1/booking-event-types/{id}/slots \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.famulor.io/api/v1/booking-event-types/{id}/slots"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.famulor.io/api/v1/booking-event-types/{id}/slots', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.io/api/v1/booking-event-types/{id}/slots",
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;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.io/api/v1/booking-event-types/{id}/slots"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.famulor.io/api/v1/booking-event-types/{id}/slots")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.io/api/v1/booking-event-types/{id}/slots")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"event_type_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"event_type_name": "<string>",
"duration_min": 123,
"slot_increment_min": 123,
"timezone": "<string>",
"start": "2023-12-25",
"end": "2023-12-25",
"bookable_until": "2023-11-07T05:31:56Z",
"slots": [
"2023-11-07T05:31:56Z"
],
"requirements": {
"email_required": true,
"phone_required": true,
"fields": [
{
"id": "<string>",
"type": "email",
"label": "<string>",
"required": true,
"placeholder": "<string>",
"options": [
"<string>"
],
"disable_if_prefilled": true
}
],
"location_type": "<string>"
}
}
}List free slots
List the free start times of one active event type for a date range (at most 28 days; dates default to the workspace time zone). Past times, times after bookable_until, and appointments that overlap an observed public holiday closure are excluded. Pass a returned slot unchanged as start to POST /bookings or POST /bookings/{id}/reschedule; when moving a booking, pass exclude_booking_id so its own time does not block nearby slots.
Returns 409 instead of 200 when the event type is turned off, or when the workspace has not set up its public booking address yet.
A 503 here can mean either request protection is temporarily unavailable (internal_error) or the availability engine itself failed to load (service_unavailable, message “Could not load availability”).
Required scope: bookings:read (keys without scope restrictions have full access).
curl --request GET \
--url https://app.famulor.io/api/v1/booking-event-types/{id}/slots \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.famulor.io/api/v1/booking-event-types/{id}/slots"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.famulor.io/api/v1/booking-event-types/{id}/slots', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.io/api/v1/booking-event-types/{id}/slots",
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;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.io/api/v1/booking-event-types/{id}/slots"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.famulor.io/api/v1/booking-event-types/{id}/slots")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.io/api/v1/booking-event-types/{id}/slots")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"event_type_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"event_type_name": "<string>",
"duration_min": 123,
"slot_increment_min": 123,
"timezone": "<string>",
"start": "2023-12-25",
"end": "2023-12-25",
"bookable_until": "2023-11-07T05:31:56Z",
"slots": [
"2023-11-07T05:31:56Z"
],
"requirements": {
"email_required": true,
"phone_required": true,
"fields": [
{
"id": "<string>",
"type": "email",
"label": "<string>",
"required": true,
"placeholder": "<string>",
"options": [
"<string>"
],
"disable_if_prefilled": true
}
],
"location_type": "<string>"
}
}
}Authorizations
API key (fam_..., created under Settings → API Keys) or an OAuth 2.0 access token (fam_at_...). REST operations also require API Access for the credential's workspace. Keys can be restricted to scopes such as assistants:read, calls:write, campaigns:write, automations:read, dashboards:read, dashboards:write, leads:write, segments:write, loop:read, loop:write, phone_numbers:write, sip_trunks:write, knowledge:write, voices:read, billing:read, billing:write, settings:write, platform:read, platform:write; a *:write scope implies the matching *:read. Automation and dashboard endpoints also accept the legacy calls:* scope. Keys without scope restrictions have full access within the workspace's available capabilities.