> ## 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 Available Time Slots by ID > Query bookable time slots for a scheduling page by the id the list endpoint returns, with no owner slug to work out. ## OpenAPI ````yaml GET /event-types/{uuid}/availability 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 - name: Routing Forms - Forms description: Read routing forms with their questions and their routes - name: Routing Forms - Submissions description: Read and delete the submissions that invitees send through a routing form paths: /event-types/{uuid}/availability: parameters: - schema: type: string name: uuid in: path required: true description: The scheduling page's id, as `GET /event-types` returns it. get: tags: - Scheduling Pages summary: Get available time slots of a scheduling page by id description: >- Returns available time slots for a scheduling page addressed by its id, with the same query parameters and response as `GET /availability/{ownerSlug}/event-types/{eventTypeSlug}`. Use it when you hold the id from `GET /event-types`: it works the same for personal, team and workspace scheduling pages, so there is no owner slug to work out. Please note that access to this endpoint requires an **active paid subscription**. This API requires either of the following scopes: - `admin:full` - `timetable` A scheduling page that is turned off returns `404`. So does a secret scheduling page, unless the token belongs to someone who can see that page in Zeeg. operationId: get-event-type-availability-by-id parameters: - schema: type: string format: date example: '2026-04-01' in: query name: startDate required: true description: Start date in YYYY-MM-DD format. - schema: type: string format: date example: '2026-04-14' in: query name: endDate required: true description: End date in YYYY-MM-DD format. - schema: type: string example: Europe/Berlin default: UTC in: query name: timeZone required: true description: IANA time zone identifier. - schema: type: number example: 30 in: query name: duration description: >- Meeting duration in minutes. Defaults to the event type's configured duration. - schema: type: boolean in: query name: withHostsCount description: >- Set to `1` to include available host count for each time slot (useful for Round Robin events). When enabled, slots will be returned as objects with `time` and `availableHosts` properties instead of simple time strings. - schema: type: string format: email in: query name: hostEmail description: >- Email of the host to filter available slots for (useful for Round Robin events). - schema: type: string in: query name: hostSlug description: >- Slug of the host to filter available slots for (useful for Round Robin events). - schema: type: boolean in: query name: check_first_available description: >- When set to `1`, the response will include the first available date for the scheduling page. - schema: type: integer minimum: 1 in: query name: seats description: Number of seats to book (for group event types). - schema: type: string example: loc_42 in: query name: locationKey description: >- Optional location-aware availability. The per-location stable key from the location resource's `key` field (e.g. `loc_42`), or `room_` for a room. The bare location enum string (e.g. `ZOOM`) is still accepted for backward compatibility. For a Round Robin event type it prunes availability to hosts that can fulfill that location (Meet/Teams/Skype/Zoom/Webex/Demodesk integration), and for a room location it intersects only that room's calendar. Omit for unfiltered availability (the default, pre-location-aware behavior). responses: '200': description: > OK - Empty slot arrays indicate dates with no availability. - The `isNotAvailable` flag indicates if the scheduling page has no availability during the time range. - When `withHostsCount=1` is used in the request, slots are returned as objects containing both time and available host count. - When `hostEmail` or `hostSlug` is used, the response will only include available slots for the specified host. content: application/json: schema: type: object properties: ownerSlug: type: string eventTypeSlug: type: string schedulingUrl: type: string format: uri duration: type: integer firstAvailableDate: type: string format: date lastAvailableDate: type: string format: date timeZone: type: string timeZoneOffset: type: string isNotAvailable: type: boolean availability: type: array items: type: object properties: date: type: string format: date slots: type: array description: >- Array of time strings (e.g. "09:00") or objects with `time` and `availableHosts` when `withHostsCount=1`. items: oneOf: - type: string - type: object properties: time: type: string availableHosts: type: integer currentTime: type: string format: date-time examples: Default without host count: value: ownerSlug: lena-meier eventTypeSlug: 30min-discovery-call schedulingUrl: https://zeeg.me/lena-meier/30min-discovery-call duration: 30 firstAvailableDate: '2026-04-01' lastAvailableDate: '2026-04-14' timeZone: Europe/Berlin timeZoneOffset: '+02:00' isNotAvailable: false availability: - date: '2026-04-01' slots: - '09:00' - '09:30' - '10:00' - '10:30' - '14:00' - '14:30' - '15:00' - '15:30' - '16:00' - date: '2026-04-02' slots: - '09:00' - '09:30' - '10:00' - '11:00' - '11:30' - '14:00' - '15:00' - '15:30' - date: '2026-04-03' slots: - '09:00' - '10:30' - '11:00' - '14:00' - '14:30' - '15:00' - '15:30' - '16:00' - date: '2026-04-04' slots: [] - date: '2026-04-05' slots: [] - date: '2026-04-06' slots: - '09:00' - '09:30' - '10:00' - '10:30' - '11:00' - '14:00' - '14:30' - '15:00' - date: '2026-04-07' slots: - '09:00' - '09:30' - '10:00' - '10:30' - '11:00' - '11:30' - '14:00' - '14:30' - '15:00' - '15:30' - '16:00' - date: '2026-04-08' slots: - '09:00' - '09:30' - '14:00' - '14:30' - '15:00' - date: '2026-04-09' slots: - '09:00' - '09:30' - '10:00' - '10:30' - '11:00' - '11:30' - '14:00' - '14:30' - date: '2026-04-10' slots: - '09:00' - '09:30' - '10:00' - '14:00' - '14:30' - '15:00' - '15:30' - '16:00' - date: '2026-04-11' slots: [] - date: '2026-04-12' slots: [] - date: '2026-04-13' slots: - '09:00' - '09:30' - '10:00' - '10:30' - '14:00' - '14:30' - '15:00' - '15:30' - '16:00' - date: '2026-04-14' slots: - '09:00' - '09:30' - '10:00' - '10:30' - '11:00' - '11:30' - '14:00' - '14:30' - '15:00' currentTime: '2026-03-20T12:00:00+00:00' Times with host count: value: ownerSlug: customer-success eventTypeSlug: 30min-discovery-call schedulingUrl: https://zeeg.me/customer-success/30min-discovery-call duration: 30 firstAvailableDate: '2026-04-01' lastAvailableDate: '2026-04-14' timeZone: Europe/Berlin timeZoneOffset: '+02:00' isNotAvailable: false availability: - date: '2026-04-01' slots: - time: '09:00' availableHosts: 2 - time: '09:30' availableHosts: 2 - time: '10:00' availableHosts: 1 - time: '10:30' availableHosts: 1 - time: '14:00' availableHosts: 2 - time: '14:30' availableHosts: 1 - time: '15:00' availableHosts: 1 - date: '2026-04-02' slots: - time: '09:00' availableHosts: 1 - time: '09:30' availableHosts: 1 - time: '10:00' availableHosts: 2 - time: '11:00' availableHosts: 1 - time: '14:00' availableHosts: 2 - time: '15:00' availableHosts: 1 - date: '2026-04-03' slots: - time: '09:00' availableHosts: 1 - time: '10:00' availableHosts: 2 - time: '11:00' availableHosts: 1 - time: '14:00' availableHosts: 2 - time: '15:00' availableHosts: 1 - date: '2026-04-04' slots: [] - date: '2026-04-05' slots: [] - date: '2026-04-06' slots: - time: '09:00' availableHosts: 2 - time: '09:30' availableHosts: 1 - time: '10:00' availableHosts: 1 - time: '14:00' availableHosts: 2 - time: '14:30' availableHosts: 1 currentTime: '2026-03-20T12:00:00+00:00' '401': $ref: '#/components/responses/401' '403': description: Forbidden content: application/json: schema: type: object properties: error: type: object properties: type: type: string message: type: string error_id: type: string required_scopes: type: array items: type: string examples: Premium scope error: value: error: type: insufficient_scope message: >- Premium scope access denied. Premium API scopes (Timetable, Booking) require a paid subscription. Please upgrade your plan. error_id: 63791640-cc01-4636-95e3-79d223db2516 required_scopes: - timetable Missing scope: value: error: type: insufficient_scope message: >- Your token is missing the required scope(s). Include at least one of: timetable. error_id: ab97b5cd-5732-45b9-b42d-a9e46106dc1d required_scopes: - timetable '404': description: Not Found content: application/json: schema: type: object properties: error: type: string examples: Owner slug not found: value: error: Slug not found Event type not found: value: error: Entry for EventType not found Host not found: value: error: Host not found '422': description: Unprocessable Entity content: application/json: schema: type: object properties: message: type: string errors: type: object examples: Missing required fields: value: message: The start date field is required. (and 1 more error) errors: startDate: - The start date field is required. endDate: - The end date field is required. security: - bearer: [] components: 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: '' ````