> ## Documentation Index
> Fetch the complete documentation index at: https://developer.zeeg.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a Scheduling Page

> Retrieve a single scheduling page by UUID, including its profile, custom invitee questions, duration, and configuration.



## OpenAPI

````yaml GET /event-types/{uuid}
openapi: 3.0.0
info:
  title: Zeeg Public API
  description: >-
    Zeeg public API documentation.


    ## Authentication

    All endpoints require a Bearer token. You can generate an API token from
    [your Zeeg dashboard](https://app.zeeg.me/account/settings/api-access).


    Each token is scoped to specific permissions (e.g. `events:read`,
    `webhooks:write`). Make sure your token has the required scopes for the
    endpoints you want to use.


    ## Recommended Headers

    We recommend including the `Accept: application/json` header in all API
    requests to ensure you receive JSON responses.
  version: 2.0.0
  x-logo:
    url: https://app.zeeg.me/img/logo-dark.2ca83593.svg
    backgroundColor: '#f7f7f9'
    altText: zeeg
  contact:
    name: Zeeg Support
    email: support@zeeg.me
    url: https://zeeg.me/en/contact
  license:
    name: Proprietary
    url: https://zeeg.me/en/legal/terms
  termsOfService: https://zeeg.me/en/legal/terms
servers:
  - url: https://api.zeeg.me/v2
    description: Production
security:
  - bearer: []
tags:
  - name: Scheduled Events
    description: Management of events scheduled via Zeeg
  - name: Scheduling Pages
    description: Scheduling pages information and management
  - name: Availability Schedule
    description: Read and change availability for users
  - name: Webhooks
    description: Webhooks management
  - name: Notes
    description: Notes for scheduled events
  - name: Workspaces & Teams
    description: Workspace users and team member management
  - name: AI Agent
    description: AI Agent integration endpoints
  - name: Payloads
    description: Webhook payload schemas
  - name: CRM - Objects
    description: >-
      Discover the schema of CRM objects (standard and custom) including all
      attribute definitions
  - name: CRM - Companies
    description: Create, read, update, and delete CRM company records
  - name: CRM - People
    description: Create, read, update, and delete CRM person records
paths:
  /event-types/{uuid}:
    parameters:
      - schema:
          type: string
          format: uuid
        name: uuid
        in: path
        required: true
        description: UUID of a specific scheduling page
    get:
      tags:
        - Scheduling Pages
      summary: Get a scheduling page
      description: Returns a specific scheduling page.
      operationId: get-api-event-type
      parameters: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - resource
                properties:
                  resource:
                    $ref: '#/components/schemas/SchedulingPageDetail'
              examples:
                All details of a scheduling page:
                  value:
                    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
                Round-robin page with per-host schedules:
                  value:
                    resource:
                      uri: >-
                        https://api.zeeg.me/v2/event-types/3f8a1c2d-5b6e-4f7a-9c0d-1e2f3a4b5c6d
                      uuid: 3f8a1c2d-5b6e-4f7a-9c0d-1e2f3a4b5c6d
                      title: Kostenloses Erstgespräch
                      type: ROUND_ROBIN
                      slug: erstgespraech
                      schedulingUrl: https://zeeg.me/R/erstgespraech
                      isActive: true
                      duration: 45
                      eventDurations:
                        - minutes: 45
                          default: true
                      profile:
                        type: Organization
                        id: 1842
                        title: Horizon Digital GmbH
                        logoUrl: null
                      description: null
                      color: 2196f3
                      maxActiveInvitees: 1
                      inviteeNameFormat: FULL_NAME
                      inviteePhoneNumber: false
                      inviteeQuestions: []
                      availabilityType: per_host
                      schedule: null
                      hosts:
                        - uuid: 9d4e2b1a-7c3f-4a5b-8e6d-0f1a2b3c4d5e
                          firstName: Lena
                          lastName: Meier
                          email: lena.meier@horizondigital.de
                          avatarUrl: null
                          slug: lena-meier
                          priority: 2
                          schedule:
                            uri: https://api.zeeg.me/v2/schedules/Q1ZYo391da
                            uuid: Q1ZYo391da
                            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'
                            specialHours: []
                        - uuid: 5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d
                          firstName: Jonas
                          lastName: Becker
                          email: jonas.becker@horizondigital.de
                          avatarUrl: null
                          slug: jonas-becker
                          priority: 1
                          schedule:
                            uri: https://api.zeeg.me/v2/schedules/aB3xY9kQ2m
                            uuid: aB3xY9kQ2m
                            title: Erstgespräch Verfügbarkeit
                            isDefault: false
                            timezone: Europe/Berlin
                            weeklyHours:
                              - day: Mon
                                timesets:
                                  - - '10:00'
                                    - '13:00'
                              - day: Wed
                                timesets:
                                  - - '10:00'
                                    - '13:00'
                                  - - '14:00'
                                    - '16:00'
                            specialHours:
                              - date: '2026-07-01'
                                timesets: []
                      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
        '401':
          $ref: '#/components/responses/401'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              examples:
                Scheduling page not found:
                  value:
                    error: Entry for EventType not found
      security:
        - bearer: []
components:
  schemas:
    SchedulingPageDetail:
      description: >-
        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.
      allOf:
        - $ref: '#/components/schemas/SchedulingPage'
        - type: object
          properties:
            notifications:
              type: object
              description: >-
                Notification settings for this scheduling page, including
                invitee email behaviour, host email behaviour and the templates
                used by the dashboard UI.
              properties:
                inviteeConfirmation:
                  type: string
                  enum:
                    - calendar_invitation
                    - email
                    - none
                  description: >-
                    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.
                addEventLinkNotif:
                  type: boolean
                  description: >-
                    When true, invitee notification emails include a link to the
                    event detail page.
                bccEmails:
                  type: array
                  nullable: true
                  maxItems: 3
                  description: >-
                    Up to three email addresses that are BCC'd on invitee
                    notification emails. Business-plan feature; `null` or an
                    empty array when unused.
                  items:
                    type: string
                    format: email
                excludePII:
                  type: boolean
                  description: >-
                    When true, host notification emails omit the invitee's
                    personal information.
                excludeHostEmails:
                  type: boolean
                  description: >-
                    When true, hosts do not receive confirmation, update or
                    cancellation emails for events booked on this scheduling
                    page.
                privateCalendarEvent:
                  type: boolean
                  description: >-
                    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.
                defaultNotifications:
                  type: object
                  description: >-
                    Pre-filled default templates (subject, body and available
                    variables) for invitee-facing emails, keyed by notification
                    type. Primarily consumed by the dashboard UI.
                  additionalProperties: true
                customNotifications:
                  type: object
                  description: >-
                    Customized template overrides (subject and body), keyed by
                    notification type. Only populated for notification types the
                    user has customized.
                  additionalProperties: true
                notificationVariables:
                  type: array
                  description: >-
                    Template variables available for use in custom notification
                    templates.
                  items:
                    type: object
                    properties:
                      key:
                        type: string
                      title:
                        type: string
            hosts:
              type: array
              description: >-
                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.
              items:
                type: object
                properties:
                  uuid:
                    type: string
                    description: Stable identifier of the host user.
                  firstName:
                    type: string
                  lastName:
                    type: string
                    nullable: true
                  email:
                    type: string
                    format: email
                  avatarUrl:
                    type: string
                    format: uri
                    nullable: true
                  slug:
                    type: string
                  priority:
                    type: integer
                    nullable: true
                    description: Round-robin priority weighting, when applicable.
                  schedule:
                    nullable: true
                    allOf:
                      - $ref: '#/components/schemas/EmbeddedSchedule'
                      - type: object
                        required:
                          - isDefault
                        properties:
                          isDefault:
                            type: boolean
                            description: >-
                              Whether this is the host's default schedule, or
                              one dedicated to this page.
                    x-mint:
                      post:
                        - Alpha
                    description: >-
                      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`).
            flexiCollections:
              type: array
              description: >-
                Host collections for FLEXI scheduling pages. Empty for all other
                page types.
              items:
                type: object
                properties:
                  hostStatus:
                    type: string
                  members:
                    type: array
                    items:
                      type: object
                      properties:
                        uuid:
                          type: string
                        firstName:
                          type: string
                        lastName:
                          type: string
                          nullable: true
                        email:
                          type: string
                          format: email
                        avatarUrl:
                          type: string
                          format: uri
                          nullable: true
                        slug:
                          type: string
            schedule:
              nullable: true
              allOf:
                - $ref: '#/components/schemas/EmbeddedSchedule'
              x-mint:
                post:
                  - Alpha
              description: >-
                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`.
            currentTime:
              type: string
              format: date-time
              description: Current server time
            isSecret:
              type: boolean
    SchedulingPage:
      type: object
      required:
        - uri
        - uuid
        - title
        - type
        - slug
        - schedulingUrl
        - isActive
        - duration
        - profile
        - color
        - maxActiveInvitees
        - inviteeNameFormat
      properties:
        uri:
          type: string
          format: uri
        uuid:
          type: string
          format: uuid
        title:
          type: string
        type:
          type: string
        slug:
          type: string
        schedulingUrl:
          type: string
          format: uri
        isActive:
          type: boolean
        duration:
          type: integer
        eventDurations:
          type: array
          items:
            type: object
            properties:
              minutes:
                type: integer
              default:
                type: boolean
        profile:
          type: object
          nullable: true
          required:
            - type
          properties:
            type:
              type: string
            firstName:
              type: string
            lastName:
              type: string
              nullable: true
            slug:
              type: string
            url:
              type: string
              format: uri
            avatarUrl:
              type: string
              format: uri
              nullable: true
            email:
              type: string
              format: email
        description:
          type: string
          nullable: true
        color:
          type: string
        maxActiveInvitees:
          type: integer
        inviteeNameFormat:
          type: string
        inviteePhoneNumber:
          type: boolean
        inviteeQuestions:
          type: array
          nullable: true
          items:
            type: object
            required:
              - order
              - question
              - isActive
              - isRequired
              - type
            properties:
              id:
                type: integer
                description: >-
                  Numeric ID of the question, used when submitting answers via
                  the booking API.
              order:
                type: integer
              question:
                type: string
              isActive:
                type: boolean
              isRequired:
                type: boolean
              type:
                type: string
              options:
                type: array
                nullable: true
                items: {}
        availabilityType:
          type: string
          enum:
            - shared
            - per_host
          x-mint:
            post:
              - Alpha
          description: >-
            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`.
        schedule:
          type: object
          nullable: true
          required:
            - uri
            - uuid
            - title
          x-mint:
            post:
              - Alpha
          description: >-
            Reference to the page-level availability schedule shared by all
            hosts. `null` when `availabilityType` is `per_host`. In list
            responses this is a reference only; the single-page endpoint inlines
            the full schedule (hours and overrides).
          properties:
            uri:
              type: string
              format: uri
              example: https://api.zeeg.me/v2/schedules/Q1ZYo391da
              description: API resource URI for this schedule
            uuid:
              type: string
              description: Schedule identifier
              example: Q1ZYo391da
            title:
              type: string
              description: Display name of the schedule
      description: A scheduling page (event type) as returned in list responses.
    EmbeddedSchedule:
      type: object
      description: >-
        An availability schedule embedded in a scheduling-page response. Same
        identifiers and hours vocabulary as the Availability Schedules
        endpoints; `uuid` can be used directly with `GET /schedules/{uuid}`.
        User-level time off (vacation, out-of-office) is per user, not per
        schedule, and is not embedded — fetch it via `GET
        /schedules?email={host}`.
      required:
        - uri
        - uuid
        - title
        - timezone
        - weeklyHours
        - specialHours
      properties:
        uri:
          type: string
          format: uri
          example: https://api.zeeg.me/v2/schedules/Q1ZYo391da
          description: API resource URI for this schedule
        uuid:
          type: string
          description: Schedule identifier
          example: Q1ZYo391da
        title:
          type: string
          description: Display name of the schedule
        timezone:
          type: string
          description: IANA timezone identifier
        weeklyHours:
          type: array
          items:
            type: object
            properties:
              day:
                type: string
                enum:
                  - Mon
                  - Tue
                  - Wed
                  - Thu
                  - Fri
                  - Sat
                  - Sun
                description: Day of the week (3-letter).
              timesets:
                type: array
                items:
                  type: array
                  minItems: 2
                  maxItems: 2
                  items:
                    type: string
                    pattern: ^\d{2}:\d{2}$
                description: Time intervals for the day
          description: Weekly recurring availability hours
        specialHours:
          type: array
          nullable: true
          items:
            type: object
            properties:
              date:
                type: string
                format: date
              timesets:
                type: array
                nullable: true
                items:
                  type: array
                  minItems: 2
                  maxItems: 2
                  items:
                    type: string
                    pattern: ^\d{2}:\d{2}$
          description: Date-specific availability overrides
  responses:
    '401':
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Unauthenticated.
          examples:
            Unauthenticated:
              value:
                message: Unauthenticated.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: ''

````