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

# Get Schedule

> Retrieves a single schedule by its ID.



## OpenAPI

````yaml openapi/schedules.json GET /v1/schedules/{schedule_id}
openapi: 3.0.3
info:
  title: Schedules API
  version: 1.0.0
servers:
  - url: https://api.olostep.com
security: []
paths:
  /v1/schedules/{schedule_id}:
    get:
      summary: Get Schedule
      description: Retrieves a single schedule by its ID.
      parameters:
        - name: schedule_id
          in: path
          required: true
          description: Unique identifier for the schedule. Must start with 'schedule_'.
          schema:
            type: string
            pattern: ^schedule_
      responses:
        '200':
          description: Schedule retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  schedule:
                    type: object
                    properties:
                      team_id:
                        type: string
                        description: Team identifier
                      schedule_id:
                        type: string
                        description: Unique schedule identifier
                      type:
                        type: string
                        enum:
                          - recurring
                          - onetime
                        description: Type of schedule
                      endpoint:
                        type: string
                        description: The endpoint URL
                      payload:
                        type: object
                        description: The payload to send with the API call
                      cron_expression:
                        type: string
                        description: Cron expression (only present for recurring schedules)
                      execute_at:
                        type: string
                        format: date-time
                        description: >-
                          Execution datetime (only present for one-time
                          schedules)
                      expression_timezone:
                        type: string
                        description: Timezone for the schedule
                      text:
                        type: string
                        description: Natural language text used to generate cron expression
                      schedule_name:
                        type: string
                        description: Internal schedule name in EventBridge
                      schedule_group:
                        type: string
                        description: Schedule group name
                      created_at:
                        type: string
                        format: date-time
                        description: ISO 8601 datetime when the schedule was created
                      updated_at:
                        type: string
                        format: date-time
                        description: ISO 8601 datetime when the schedule was last updated
                      state:
                        type: string
                        enum:
                          - ENABLED
                          - DELETED
                        description: Current state of the schedule
                      method:
                        type: string
                        enum:
                          - GET
                          - POST
                        description: HTTP method for the scheduled call
        '400':
          description: >-
            Bad request due to invalid schedule_id format. Schedule ID must
            start with 'schedule_'.
        '401':
          description: Invalid API key.
        '404':
          description: Schedule not found for the provided ID.
        '500':
          description: Internal server error while fetching schedule.
      security:
        - Authorization: []
components:
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: >-
        Bearer authentication header of the form Bearer <token>, where <token>
        is your auth token.

````