> ## 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 Availability Schedule by UUID > Retrieve a specific availability schedule by its UUID, with weekly working hours, time zone, and any date-specific overrides. ## OpenAPI ````yaml GET /schedules/{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: /schedules/{uuid}: parameters: - schema: type: string format: uuid example: Q1ZYo391da name: uuid in: path required: true description: Schedule identifier get: tags: - Availability Schedule summary: Get availability schedule by UUID description: Returns a specific availability schedule by its UUID. operationId: get-schedules-uuid parameters: - schema: type: string format: email example: lena.meier@horizondigital.de in: query name: email required: true description: Email address of the user who owns the schedule. - schema: type: boolean default: false example: true in: query name: includeSchedulingPages description: >- When true, includes the list of scheduling pages associated with the schedule. responses: '200': description: OK content: application/json: schema: type: object properties: success: type: boolean example: true status: type: integer example: 200 resource: type: object properties: uri: type: string format: uri description: API resource URI for this schedule uuid: type: string format: uuid email: type: string format: email description: Email address of the schedule owner title: type: string description: Display name of the schedule isDefault: type: boolean description: Whether this is the default 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}$ 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}$ schedulingPages: type: array description: >- Scheduling pages linked to this schedule. Only present when `includeSchedulingPages=true`. items: type: object properties: uuid: type: string format: uuid title: type: string slug: type: string schedulingUrl: type: string format: uri currentTime: type: string description: Current server time createdAt: type: string format: date-time description: Timestamp of creation updatedAt: type: string format: date-time description: Timestamp of last update required: - resource examples: Schedule by UUID: value: success: true status: 200 resource: 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' '401': $ref: '#/components/responses/401' '403': description: Forbidden content: application/json: schema: type: object properties: success: type: boolean message: type: string status: type: integer examples: Missing scope: value: success: false message: >- Your token is missing the required scope(s). Include at least one of: schedules:read, schedules:write. status: 403 '404': description: Not Found content: application/json: schema: type: object properties: error: type: string examples: Schedule not found: value: error: Schedule not found 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: '' ````