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

{
  "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.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>'

{
  "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
  }
}

Documentation Index

Authorizations

Query Parameters

Response