> ## 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 All Availability Schedules > Retrieve all availability schedules belonging to the authenticated user, including weekly hours, time zone, and date overrides. ## OpenAPI ````yaml GET /schedules 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: parameters: [] get: tags: - Availability Schedule summary: Get all availability schedules description: >- Returns a paginated list of availability schedules for the specified user. Each schedule contains weekly recurring hours and optional special date overrides. operationId: get-schedules parameters: - schema: type: string format: email example: lena.meier@horizondigital.de in: query name: email required: true description: Email address of the user whose schedules to retrieve. - schema: type: number default: 20 minimum: 1 maximum: 100 example: 10 in: query name: count description: Limit the number of returned results per page. - schema: type: number minimum: 1 default: 1 example: 1 in: query name: page description: Page number for paginated results. - schema: type: boolean default: false example: true in: query name: includeSchedulingPages description: >- When true, includes the list of scheduling pages associated with each schedule. responses: '200': description: OK content: application/json: schema: type: object properties: collection: type: array items: type: object 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 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}$ 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 timeOff: type: array description: >- 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. items: type: object properties: uuid: type: string format: uuid type: type: string enum: - vacation - out_of_office title: type: string nullable: true startDate: type: string format: date endDate: type: string format: date startHalfDay: type: boolean endHalfDay: type: boolean startHalfDayCutoff: type: string nullable: true description: >- Half-day cutoff (HH:MM), null when startHalfDay is false. endHalfDayCutoff: type: string nullable: true description: >- Half-day cutoff (HH:MM), null when endHalfDay is false. note: type: string nullable: true schedulingPages: type: array description: 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 description: List of availability schedules pagination: type: object required: - total - count - totalPages - currentPage properties: total: type: integer minimum: 0 description: Total number of records. count: type: integer minimum: 0 default: 20 description: Number of records per page. totalPages: type: integer minimum: 0 description: Total number of pages. previousPage: type: string nullable: true description: Link to previous page, or null. example: /v2/schedules?page=1 currentPage: type: integer minimum: 1 description: Current page number. nextPage: type: string nullable: true description: Link to next page, or null. example: /v2/schedules?page=3 required: - collection - pagination examples: Two schedules: value: 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 Empty result: value: collection: [] pagination: total: 0 count: 0 totalPages: 0 previousPage: null currentPage: 1 nextPage: null '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: Forbidden: value: success: false status: 403 message: Not allowed to see this resource. '422': description: Unprocessable Entity content: application/json: schema: type: object properties: message: type: string errors: type: object properties: email: type: array items: type: string examples: Email required: value: message: The email field is required. errors: email: - The email 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: '' ````