Get All Availability Schedules - Zeeg Developer Hub

GET

schedules

Get all availability schedules

curl --request GET \
  --url https://api.zeeg.me/v2/schedules \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.zeeg.me/v2/schedules"

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', 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",
  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"

	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")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.zeeg.me/v2/schedules")

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

{
  "collection": [
    {
      "uri": "https://api.zeeg.me/v2/schedules/Q1ZYo391da",
      "uuid": "Q1ZYo391da",
      "email": "lena.meier@horizondigital.de",
      "title": "Working Hours",
      "isDefault": true,
      "timezone": "Europe/Berlin",
      "weeklyHours": [
        {
          "day": "Mon",
          "timesets": [
            [
              "09:00",
              "17:00"
            ]
          ]
        },
        {
          "day": "Tue",
          "timesets": [
            [
              "09:00",
              "17:00"
            ]
          ]
        },
        {
          "day": "Wed",
          "timesets": [
            [
              "09:00",
              "17:00"
            ]
          ]
        },
        {
          "day": "Thu",
          "timesets": [
            [
              "09:00",
              "17:00"
            ]
          ]
        },
        {
          "day": "Fri",
          "timesets": [
            [
              "09:00",
              "17:00"
            ]
          ]
        },
        {
          "day": "Sat",
          "timesets": []
        },
        {
          "day": "Sun",
          "timesets": []
        }
      ],
      "specialHours": [
        {
          "date": "2026-04-21",
          "timesets": [
            [
              "10:00",
              "14:00"
            ]
          ]
        }
      ],
      "schedulingPages": [
        {
          "uuid": "80f46bf5-eb01-4c07-960e-a9a3e18aae5e",
          "title": "30-Minute Discovery Call",
          "slug": "30min-discovery-call",
          "schedulingUrl": "https://zeeg.me/lena-meier/30min-discovery-call"
        }
      ],
      "currentTime": "2026-04-10T08:30:00+02:00",
      "createdAt": "2026-04-01T10:00:00.000000Z",
      "updatedAt": "2026-04-05T14:30:00.000000Z"
    },
    {
      "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"
    }
  ],
  "pagination": {
    "total": 2,
    "count": 2,
    "totalPages": 1,
    "previousPage": null,
    "currentPage": 1,
    "nextPage": null
  }
}

Authorizations

Authorization

string

header

required

Query Parameters

string<email>

required

Email address of the user whose schedules to retrieve.

Example:

"lena.meier@horizondigital.de"

count

number

default:20

Limit the number of returned results per page.

Required range: 1 <= x <= 100

Example:

10

page

number

default:1

Page number for paginated results.

Required range: x >= 1

Example:

1

includeSchedulingPages

boolean

default:false

When true, includes the list of scheduling pages associated with each schedule.

Example:

true

Response

collection

object[]

required

List of availability schedules

Hide child attributes

collection.uri

string<uri>

API resource URI for this schedule

Example:

"https://api.zeeg.me/v2/schedules/Q1ZYo391da"

collection.uuid

string

Schedule identifier

Example:

"Q1ZYo391da"

collection.email

string<email>

Email address of the schedule owner

collection.title

string

Display name of the schedule

collection.isDefault

boolean

Whether this is the default schedule

collection.timezone

string

IANA timezone identifier

collection.weeklyHours

object[]

Weekly recurring availability hours

Hide child attributes

collection.weeklyHours.day

enum<string>

Day of the week (3-letter).

Available options:

Mon,

Tue,

Wed,

Thu,

Fri,

Sat,

Sun

collection.weeklyHours.timesets

string[][]

Time intervals for the day

Required array length: 2 elements

Pattern: ^\d{2}:\d{2}$

collection.specialHours

object[] | null

Date-specific availability overrides

Hide child attributes

collection.specialHours.date

string<date>

collection.specialHours.timesets

string[][] | null

Required array length: 2 elements

Pattern: ^\d{2}:\d{2}$

collection.timeOff

object[]

User-level time-off periods (vacation, out-of-office) that apply across all of the user's scheduling pages. Only periods ending today or in the future are returned. Half-day flags indicate the first/last day of the period is partial.

Hide child attributes

collection.timeOff.uuid

string<uuid>

collection.timeOff.uri

string<uri>

Canonical URL of the time-off period.

collection.timeOff.type

enum<string>

Available options:

vacation,

out_of_office

collection.timeOff.title

string | null

collection.timeOff.startDate

string<date>

collection.timeOff.endDate

string<date>

collection.timeOff.startHalfDay

boolean

collection.timeOff.endHalfDay

boolean

collection.timeOff.startHalfDayCutoff

string | null

Half-day cutoff (HH:MM), null when startHalfDay is false.

collection.timeOff.endHalfDayCutoff

string | null

Half-day cutoff (HH:MM), null when endHalfDay is false.

collection.timeOff.note

string | null

collection.schedulingPages

object[]

Only present when includeSchedulingPages=true.

Hide child attributes

collection.schedulingPages.uuid

string<uuid>

collection.schedulingPages.title

string

collection.schedulingPages.slug

string

collection.schedulingPages.schedulingUrl

string<uri>

collection.currentTime

string

Current server time

collection.createdAt

string<date-time>

Timestamp of creation

collection.updatedAt

string<date-time>

Timestamp of last update

pagination

object

required

Hide child attributes

pagination.total

integer

required

Total number of records.

Required range: x >= 0

pagination.count

integer

default:20

required

Number of records per page.

Required range: x >= 0

pagination.totalPages

integer

required

Total number of pages.

Required range: x >= 0

pagination.currentPage

integer

required

Current page number.

Required range: x >= 1

pagination.previousPage

string | null

Link to previous page, or null.

Example:

"/v2/schedules?page=1"

pagination.nextPage

string | null

Link to next page, or null.

Example:

"/v2/schedules?page=3"

Last modified on April 29, 2026

Create an Event

Get Default Availability Schedule

Get all availability schedules

curl --request GET \
  --url https://api.zeeg.me/v2/schedules \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.zeeg.me/v2/schedules"

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', 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",
  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"

	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")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.zeeg.me/v2/schedules")

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

{
  "collection": [
    {
      "uri": "https://api.zeeg.me/v2/schedules/Q1ZYo391da",
      "uuid": "Q1ZYo391da",
      "email": "lena.meier@horizondigital.de",
      "title": "Working Hours",
      "isDefault": true,
      "timezone": "Europe/Berlin",
      "weeklyHours": [
        {
          "day": "Mon",
          "timesets": [
            [
              "09:00",
              "17:00"
            ]
          ]
        },
        {
          "day": "Tue",
          "timesets": [
            [
              "09:00",
              "17:00"
            ]
          ]
        },
        {
          "day": "Wed",
          "timesets": [
            [
              "09:00",
              "17:00"
            ]
          ]
        },
        {
          "day": "Thu",
          "timesets": [
            [
              "09:00",
              "17:00"
            ]
          ]
        },
        {
          "day": "Fri",
          "timesets": [
            [
              "09:00",
              "17:00"
            ]
          ]
        },
        {
          "day": "Sat",
          "timesets": []
        },
        {
          "day": "Sun",
          "timesets": []
        }
      ],
      "specialHours": [
        {
          "date": "2026-04-21",
          "timesets": [
            [
              "10:00",
              "14:00"
            ]
          ]
        }
      ],
      "schedulingPages": [
        {
          "uuid": "80f46bf5-eb01-4c07-960e-a9a3e18aae5e",
          "title": "30-Minute Discovery Call",
          "slug": "30min-discovery-call",
          "schedulingUrl": "https://zeeg.me/lena-meier/30min-discovery-call"
        }
      ],
      "currentTime": "2026-04-10T08:30:00+02:00",
      "createdAt": "2026-04-01T10:00:00.000000Z",
      "updatedAt": "2026-04-05T14:30:00.000000Z"
    },
    {
      "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"
    }
  ],
  "pagination": {
    "total": 2,
    "count": 2,
    "totalPages": 1,
    "previousPage": null,
    "currentPage": 1,
    "nextPage": null
  }
}