Availability Schedule
Get Availability Schedule by UUID
Retrieve a specific availability schedule by its UUID, with weekly working hours, time zone, and any date-specific overrides.
GET
/
schedules
/
{uuid}
Get availability schedule by UUID
curl --request GET \
--url https://api.zeeg.me/v2/schedules/{uuid} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.zeeg.me/v2/schedules/{uuid}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.zeeg.me/v2/schedules/{uuid}', 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://api.zeeg.me/v2/schedules/{uuid}",
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://api.zeeg.me/v2/schedules/{uuid}"
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://api.zeeg.me/v2/schedules/{uuid}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zeeg.me/v2/schedules/{uuid}")
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{
"success": true,
"status": 200,
"resource": {
"uri": "https://api.zeeg.me/v2/schedules/otrBCIib7j",
"uuid": "otrBCIib7j",
"email": "lena.meier@horizondigital.de",
"title": "Evening Consultations",
"isDefault": false,
"timezone": "Europe/Berlin",
"weeklyHours": [
{
"day": "Mon",
"timesets": [
[
"18:00",
"20:00"
]
]
},
{
"day": "Tue",
"timesets": [
[
"18:00",
"20:00"
]
]
},
{
"day": "Wed",
"timesets": []
},
{
"day": "Thu",
"timesets": [
[
"18:00",
"20:00"
]
]
},
{
"day": "Fri",
"timesets": []
},
{
"day": "Sat",
"timesets": []
},
{
"day": "Sun",
"timesets": []
}
],
"specialHours": null,
"schedulingPages": [],
"currentTime": "2026-04-10T08:30:00+02:00",
"createdAt": "2026-04-02T12:00:00.000000Z",
"updatedAt": "2026-04-02T12:00:00.000000Z"
}
}{
"message": "Unauthenticated."
}{
"success": false,
"message": "Your token is missing the required scope(s). Include at least one of: schedules:read, schedules:write.",
"status": 403
}{
"error": "Schedule not found"
}Authorizations
Path Parameters
Schedule identifier
Example:
"Q1ZYo391da"
Query Parameters
Email address of the user who owns the schedule.
Example:
"lena.meier@horizondigital.de"
When true, includes the list of scheduling pages associated with the schedule.
Example:
true
Response
OK
Hide child attributes
Hide child attributes
API resource URI for this schedule
Email address of the schedule owner
Display name of the schedule
Whether this is the default schedule
IANA timezone identifier
Current server time
Timestamp of creation
Timestamp of last update
Example:
true
Example:
200
Last modified on April 29, 2026
⌘I
Get availability schedule by UUID
curl --request GET \
--url https://api.zeeg.me/v2/schedules/{uuid} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.zeeg.me/v2/schedules/{uuid}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.zeeg.me/v2/schedules/{uuid}', 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://api.zeeg.me/v2/schedules/{uuid}",
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://api.zeeg.me/v2/schedules/{uuid}"
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://api.zeeg.me/v2/schedules/{uuid}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zeeg.me/v2/schedules/{uuid}")
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{
"success": true,
"status": 200,
"resource": {
"uri": "https://api.zeeg.me/v2/schedules/otrBCIib7j",
"uuid": "otrBCIib7j",
"email": "lena.meier@horizondigital.de",
"title": "Evening Consultations",
"isDefault": false,
"timezone": "Europe/Berlin",
"weeklyHours": [
{
"day": "Mon",
"timesets": [
[
"18:00",
"20:00"
]
]
},
{
"day": "Tue",
"timesets": [
[
"18:00",
"20:00"
]
]
},
{
"day": "Wed",
"timesets": []
},
{
"day": "Thu",
"timesets": [
[
"18:00",
"20:00"
]
]
},
{
"day": "Fri",
"timesets": []
},
{
"day": "Sat",
"timesets": []
},
{
"day": "Sun",
"timesets": []
}
],
"specialHours": null,
"schedulingPages": [],
"currentTime": "2026-04-10T08:30:00+02:00",
"createdAt": "2026-04-02T12:00:00.000000Z",
"updatedAt": "2026-04-02T12:00:00.000000Z"
}
}{
"message": "Unauthenticated."
}{
"success": false,
"message": "Your token is missing the required scope(s). Include at least one of: schedules:read, schedules:write.",
"status": 403
}{
"error": "Schedule not found"
}