> ## Documentation Index > Fetch the complete documentation index at: https://docs.serval.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Schedule > Retrieve a recurring schedule by ID. ## OpenAPI ````yaml /sections/api-reference/openapi-spec-v2.yaml get /v2/schedules/{id} openapi: 3.1.0 info: title: Serval Public API description: Serval Public API contact: name: Serval url: https://serval.com email: support@serval.com license: name: Serval License url: https://serval.com/license version: 2.0.0 servers: - url: https://public.api.serval.com security: - BearerAuth: [] tags: - name: Access Policy API - name: Access Policy Approval Procedure API - name: Access Profile API - name: Access Relationship API - name: Access Request API - name: Agent API - name: App Instance API - name: App Resource API - name: App Resource Role API - name: Approval Delegation API - name: Approval Procedure API - name: Approval Request API - name: Assignment Rules API - name: Audit Log API - name: Change Blackout API - name: Change Model API - name: Custom Field API - name: Custom Service API - name: Entity API - name: Entity Field Mapping API - name: Entity Ingestion Config API - name: Entity Type API - name: Folder API - name: Forms API - name: Group API - name: Guidance API - name: Help Agent API - name: Journey API - name: Knowledge API - name: Knowledge Base API - name: One-Time Window API - name: Report API - name: Roles API - name: SLA API - name: Schedule API - name: Tag API - name: Team API - name: Team Group API - name: Team User API - name: Ticket API - name: Topic API - name: User API - name: User Relationship API - name: Workflow API - name: Workflow Approval Procedure API - name: Workflow Run API paths: /v2/schedules/{id}: get: tags: - Schedule API summary: Get Schedule description: Retrieve a recurring schedule by ID. operationId: svrelay.publicv2.PublicAPIServiceV2.GetSchedule parameters: - name: id in: path required: true schema: type: string title: id responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/svhelp.publicapi.GetScheduleResponse' security: - BearerAuth: [] components: schemas: svhelp.publicapi.GetScheduleResponse: type: object properties: data: $ref: '#/components/schemas/svhelp.models.Schedule' title: data x-stainless-terraform-configurability: optional title: GetScheduleResponse additionalProperties: false svhelp.models.Schedule: type: object properties: id: type: string title: id readOnly: true x-stainless-terraform-configurability: computed teamId: type: string title: team_id readOnly: true x-stainless-terraform-configurability: computed name: type: string title: name x-stainless-terraform-configurability: optional timezone: type: string title: timezone description: IANA timezone, e.g., "America/New_York" x-stainless-terraform-configurability: optional weeklyHours: $ref: '#/components/schemas/svhelp.models.WeeklyHours' title: weekly_hours x-stainless-terraform-configurability: optional createdAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: created_at readOnly: true x-stainless-terraform-configurability: computed updatedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: updated_at readOnly: true x-stainless-terraform-configurability: computed kind: $ref: '#/components/schemas/svhelp.models.ScheduleKind' title: kind x-stainless-terraform-configurability: optional respectedHolidayWindowIds: type: array items: type: string title: respected_holiday_window_ids description: >- The HOLIDAY one-time windows this schedule respects: its SLA clock pauses on the dates those windows span. Empty = respects no holidays. x-stainless-terraform-configurability: optional scopedId: type: string title: scoped_id readOnly: true x-stainless-terraform-configurability: computed title: Schedule additionalProperties: false description: >- Schedule represents a recurring weekly time pattern. A WORK_HOURS schedule feeds the SLA clock (when it runs); a BLACKOUT schedule feeds the change-management conflict engine (when changes are blocked). svhelp.models.WeeklyHours: type: object properties: sunday: type: array items: $ref: '#/components/schemas/svhelp.models.TimeWindow' title: sunday x-stainless-terraform-configurability: optional monday: type: array items: $ref: '#/components/schemas/svhelp.models.TimeWindow' title: monday x-stainless-terraform-configurability: optional tuesday: type: array items: $ref: '#/components/schemas/svhelp.models.TimeWindow' title: tuesday x-stainless-terraform-configurability: optional wednesday: type: array items: $ref: '#/components/schemas/svhelp.models.TimeWindow' title: wednesday x-stainless-terraform-configurability: optional thursday: type: array items: $ref: '#/components/schemas/svhelp.models.TimeWindow' title: thursday x-stainless-terraform-configurability: optional friday: type: array items: $ref: '#/components/schemas/svhelp.models.TimeWindow' title: friday x-stainless-terraform-configurability: optional saturday: type: array items: $ref: '#/components/schemas/svhelp.models.TimeWindow' title: saturday x-stainless-terraform-configurability: optional title: WeeklyHours additionalProperties: false description: WeeklyHours defines business hours for each day of the week. google.protobuf.Timestamp: type: string examples: - '2025-01-15T01:30:15.000Z' - '2025-06-01T00:00:00.000Z' format: date-time description: A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z"). svhelp.models.ScheduleKind: type: string title: ScheduleKind enum: - SCHEDULE_KIND_UNSPECIFIED - SCHEDULE_KIND_WORK_HOURS - SCHEDULE_KIND_BLACKOUT description: ScheduleKind distinguishes a recurring weekly schedule's role. svhelp.models.TimeWindow: type: object properties: start: type: string title: start description: HH:MM format, e.g., "09:00" x-stainless-terraform-configurability: optional end: type: string title: end description: HH:MM format, e.g., "17:00" x-stainless-terraform-configurability: optional title: TimeWindow additionalProperties: false description: TimeWindow represents a working time window within a day. securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT ````