Get a Scheduling Page - Zeeg Developer Hub

GET

event-types

{uuid}

Get a scheduling page

curl --request GET \
  --url https://api.zeeg.me/v2/event-types/{uuid} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.zeeg.me/v2/event-types/{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/event-types/{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/event-types/{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))

}

require 'uri'
require 'net/http'

url = URI("https://api.zeeg.me/v2/event-types/{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

{
  "resource": {
    "uri": "https://api.zeeg.me/v2/event-types/80f46bf5-eb01-4c07-960e-a9a3e18aae5e",
    "uuid": "80f46bf5-eb01-4c07-960e-a9a3e18aae5e",
    "title": "30-Minute Discovery Call",
    "type": "ONE_ON_ONE",
    "slug": "30min-discovery-call",
    "schedulingUrl": "https://zeeg.me/lena-meier/30min-discovery-call",
    "isActive": true,
    "duration": 30,
    "eventDurations": [
      {
        "minutes": 30,
        "default": true
      }
    ],
    "profile": {
      "type": "User",
      "firstName": "Lena",
      "lastName": "Meier",
      "slug": "lena-meier",
      "url": "https://zeeg.me/lena-meier",
      "avatarUrl": null,
      "email": "lena.meier@horizondigital.de"
    },
    "description": "<p>Let's connect for a quick 30-minute discovery call to explore how we can help your business grow.</p>",
    "color": "2196f3",
    "maxActiveInvitees": 1,
    "inviteeNameFormat": "FULL_NAME",
    "inviteePhoneNumber": false,
    "inviteeQuestions": [
      {
        "id": 1,
        "order": 1,
        "question": "What would you like to discuss?",
        "isActive": true,
        "isRequired": true,
        "type": "TEXT_INPUT",
        "options": null
      }
    ],
    "availabilityType": "shared",
    "schedule": {
      "uri": "https://api.zeeg.me/v2/schedules/Q1ZYo391da",
      "uuid": "Q1ZYo391da",
      "title": "Working hours",
      "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"
            ]
          ]
        }
      ],
      "specialHours": []
    },
    "hosts": [],
    "notifications": {
      "inviteeConfirmation": "email",
      "addEventLinkNotif": true,
      "bccEmails": null,
      "excludePII": false,
      "excludeHostEmails": false,
      "privateCalendarEvent": false,
      "defaultNotifications": {},
      "customNotifications": {},
      "notificationVariables": []
    },
    "currentTime": "2026-03-23T10:00:00.000000Z",
    "isSecret": false
  }
}

Authorizations

Authorization

string

header

required

Path Parameters

uuid

string<uuid>

required

UUID of a specific scheduling page

Response

resource

object

required

A scheduling page (event type) with full details, as returned when fetching a single scheduling page. Extends the list shape with hosts, notifications, and Flexi configuration.

Hide child attributes

resource.uri

string<uri>

required

resource.uuid

string<uuid>

required

resource.title

string

required

resource.type

string

required

resource.slug

string

required

resource.schedulingUrl

string<uri>

required

resource.isActive

boolean

required

resource.duration

integer

required

resource.profile

object | null

required

Hide child attributes

resource.profile.type

string

required

resource.profile.firstName

string

resource.profile.lastName

string | null

resource.profile.slug

string

resource.profile.url

string<uri>

resource.profile.avatarUrl

string<uri> | null

resource.profile.email

string<email>

resource.color

string

required

resource.maxActiveInvitees

integer

required

resource.inviteeNameFormat

string

required

resource.eventDurations

object[]

Hide child attributes

resource.eventDurations.minutes

integer

resource.eventDurations.default

boolean

resource.description

string | null

resource.inviteePhoneNumber

boolean

resource.inviteeQuestions

object[] | null

Hide child attributes

resource.inviteeQuestions.order

integer

required

resource.inviteeQuestions.question

string

required

resource.inviteeQuestions.isActive

boolean

required

resource.inviteeQuestions.isRequired

boolean

required

resource.inviteeQuestions.type

string

required

resource.inviteeQuestions.id

integer

Numeric ID of the question, used when submitting answers via the booking API.

resource.inviteeQuestions.options

any[] | null

resource.availabilityType

enum<string>

Alpha

Where the availability schedule for this scheduling page lives. shared — one schedule is set on the page itself and applies to everyone; see schedule. per_host — each host has their own schedule for this page (COLLECTIVE / ROUND_ROBIN); the per-host schedules are returned on the single-page endpoint in hosts[].schedule.

Available options:

shared,

per_host

resource.schedule

object | null

Alpha

The page-level availability schedule shared by all hosts, inlined with full hours (the list endpoint returns a reference only). Only populated when availabilityType is shared.

Hide child attributes

resource.schedule.uri

string<uri>

required

API resource URI for this schedule

Example:

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

resource.schedule.uuid

string

required

Schedule identifier

Example:

"Q1ZYo391da"

resource.schedule.title

string

required

Display name of the schedule

resource.schedule.timezone

string

required

IANA timezone identifier

resource.schedule.weeklyHours

object[]

required

Weekly recurring availability hours

Hide child attributes

resource.schedule.weeklyHours.day

enum<string>

Day of the week (3-letter).

Available options:

Mon,

Tue,

Wed,

Thu,

Fri,

Sat,

Sun

resource.schedule.weeklyHours.timesets

string[][]

Time intervals for the day

Required array length: 2 elements

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

resource.schedule.specialHours

object[] | null

required

Date-specific availability overrides

Hide child attributes

resource.schedule.specialHours.date

string<date>

resource.schedule.specialHours.timesets

string[][] | null

Required array length: 2 elements

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

resource.notifications

object

Notification settings for this scheduling page, including invitee email behaviour, host email behaviour and the templates used by the dashboard UI.

Hide child attributes

resource.notifications.inviteeConfirmation

enum<string>

How the invitee is notified once a booking is confirmed. calendar_invitation sends a calendar invite from the host's connected calendar, email sends a Zeeg confirmation email, none sends nothing.

Available options:

calendar_invitation,

email,

none

resource.notifications.addEventLinkNotif

boolean

When true, invitee notification emails include a link to the event detail page.

resource.notifications.bccEmails

string<email>[] | null

Up to three email addresses that are BCC'd on invitee notification emails. Business-plan feature; null or an empty array when unused.

Maximum array length: 3

resource.notifications.excludePII

boolean

When true, host notification emails omit the invitee's personal information.

resource.notifications.excludeHostEmails

boolean

When true, hosts do not receive confirmation, update or cancellation emails for events booked on this scheduling page.

resource.notifications.privateCalendarEvent

boolean

When true, the calendar event synced to the host's connected calendar (Google, Microsoft or Exchange) is marked as private, so people with access to the host's calendar see only the busy time and not the subject, attendees or location.

resource.notifications.defaultNotifications

object

Pre-filled default templates (subject, body and available variables) for invitee-facing emails, keyed by notification type. Primarily consumed by the dashboard UI.

resource.notifications.customNotifications

object

Customized template overrides (subject and body), keyed by notification type. Only populated for notification types the user has customized.

resource.notifications.notificationVariables

object[]

Template variables available for use in custom notification templates.

Hide child attributes

resource.notifications.notificationVariables.key

string

resource.notifications.notificationVariables.title

string

resource.hosts

object[]

Assigned hosts for the scheduling page. Populated for ONE_ON_ONE, GROUP, ROUND_ROBIN and COLLECTIVE pages. For FLEXI pages this array is empty; see flexiCollections instead.

Hide child attributes

resource.hosts.uuid

string

Stable identifier of the host user.

resource.hosts.firstName

string

resource.hosts.lastName

string | null

resource.hosts.email

string<email>

resource.hosts.avatarUrl

string<uri> | null

resource.hosts.slug

string

resource.hosts.priority

integer | null

Round-robin priority weighting, when applicable.

resource.hosts.schedule

object | null

Alpha

The availability schedule this host uses for this scheduling page, inlined. Only populated when availabilityType is per_host; null when the page uses a shared schedule (see the top-level schedule).

Hide child attributes

resource.hosts.schedule.uri

string<uri>

required

API resource URI for this schedule

Example:

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

resource.hosts.schedule.uuid

string

required

Schedule identifier

Example:

"Q1ZYo391da"

resource.hosts.schedule.title

string

required

Display name of the schedule

resource.hosts.schedule.timezone

string

required

IANA timezone identifier

resource.hosts.schedule.weeklyHours

object[]

required

Weekly recurring availability hours

Hide child attributes

resource.hosts.schedule.weeklyHours.day

enum<string>

Day of the week (3-letter).

Available options:

Mon,

Tue,

Wed,

Thu,

Fri,

Sat,

Sun

resource.hosts.schedule.weeklyHours.timesets

string[][]

Time intervals for the day

Required array length: 2 elements

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

resource.hosts.schedule.specialHours

object[] | null

required

Date-specific availability overrides

Hide child attributes

resource.hosts.schedule.specialHours.date

string<date>

resource.hosts.schedule.specialHours.timesets

string[][] | null

Required array length: 2 elements

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

resource.hosts.schedule.isDefault

boolean

required

Whether this is the host's default schedule, or one dedicated to this page.

resource.flexiCollections

object[]

Host collections for FLEXI scheduling pages. Empty for all other page types.

Hide child attributes

resource.flexiCollections.hostStatus

string

resource.flexiCollections.members

object[]

Hide child attributes

resource.flexiCollections.members.uuid

string

resource.flexiCollections.members.firstName

string

resource.flexiCollections.members.lastName

string | null

resource.flexiCollections.members.email

string<email>

resource.flexiCollections.members.avatarUrl

string<uri> | null

resource.flexiCollections.members.slug

string

resource.currentTime

string<date-time>

Current server time

resource.isSecret

boolean

Last modified on April 29, 2026

Get a scheduling page

curl --request GET \
  --url https://api.zeeg.me/v2/event-types/{uuid} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.zeeg.me/v2/event-types/{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/event-types/{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/event-types/{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))

}

require 'uri'
require 'net/http'

url = URI("https://api.zeeg.me/v2/event-types/{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

{
  "resource": {
    "uri": "https://api.zeeg.me/v2/event-types/80f46bf5-eb01-4c07-960e-a9a3e18aae5e",
    "uuid": "80f46bf5-eb01-4c07-960e-a9a3e18aae5e",
    "title": "30-Minute Discovery Call",
    "type": "ONE_ON_ONE",
    "slug": "30min-discovery-call",
    "schedulingUrl": "https://zeeg.me/lena-meier/30min-discovery-call",
    "isActive": true,
    "duration": 30,
    "eventDurations": [
      {
        "minutes": 30,
        "default": true
      }
    ],
    "profile": {
      "type": "User",
      "firstName": "Lena",
      "lastName": "Meier",
      "slug": "lena-meier",
      "url": "https://zeeg.me/lena-meier",
      "avatarUrl": null,
      "email": "lena.meier@horizondigital.de"
    },
    "description": "<p>Let's connect for a quick 30-minute discovery call to explore how we can help your business grow.</p>",
    "color": "2196f3",
    "maxActiveInvitees": 1,
    "inviteeNameFormat": "FULL_NAME",
    "inviteePhoneNumber": false,
    "inviteeQuestions": [
      {
        "id": 1,
        "order": 1,
        "question": "What would you like to discuss?",
        "isActive": true,
        "isRequired": true,
        "type": "TEXT_INPUT",
        "options": null
      }
    ],
    "availabilityType": "shared",
    "schedule": {
      "uri": "https://api.zeeg.me/v2/schedules/Q1ZYo391da",
      "uuid": "Q1ZYo391da",
      "title": "Working hours",
      "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"
            ]
          ]
        }
      ],
      "specialHours": []
    },
    "hosts": [],
    "notifications": {
      "inviteeConfirmation": "email",
      "addEventLinkNotif": true,
      "bccEmails": null,
      "excludePII": false,
      "excludeHostEmails": false,
      "privateCalendarEvent": false,
      "defaultNotifications": {},
      "customNotifications": {},
      "notificationVariables": []
    },
    "currentTime": "2026-03-23T10:00:00.000000Z",
    "isSecret": false
  }
}