---
title: "Get a schedule by ID. Available only on schedules associated with GitHub OAuth or Bitbucket Cloud pipeline definitions."
method: GET
path: "/schedule/{schedule-id}"
tags: ["Schedule"]
---

# Get a schedule by ID. Available only on schedules associated with GitHub OAuth or Bitbucket Cloud pipeline definitions.

`GET /schedule/{schedule-id}`

Get a schedule by id.

## Path parameters

- `schedule-id` string, uuid, required

## Response `200`

A schedule object.

- object — A schedule response
  - `id` string, uuid, required — The unique ID of the schedule.
  - `timetable` union, required — Timetable that specifies when a schedule triggers.
    - object
      - `per-hour` integer, required — Number of times a schedule triggers per hour, value must be between 1 and 60
      - `hours-of-day` integer[], required — Hours in a day in which the schedule triggers.
      - `days-of-week` string[], required — Days in a week in which the schedule triggers.
      - `days-of-month` integer[] — Days in a month in which the schedule triggers. This is mutually exclusive with days in a week.
      - `months` string[] — Months in which the schedule triggers.
    - object
      - `per-hour` integer, required — Number of times a schedule triggers per hour, value must be between 1 and 60
      - `hours-of-day` integer[], required — Hours in a day in which the schedule triggers.
      - `days-of-month` integer[], required — Days in a month in which the schedule triggers. This is mutually exclusive with days in a week.
      - `days-of-week` string[] — Days in a week in which the schedule triggers.
      - `months` string[] — Months in which the schedule triggers.
  - `updated-at` string, date-time, required — The date and time the pipeline was last updated.
  - `name` string, required — Name of the schedule.
  - `created-at` string, date-time, required — The date and time the pipeline was created.
  - `project-slug` string, required — The project-slug for the schedule
  - `parameters` object, required — Pipeline parameters represented as key-value pairs. Must contain branch or tag.
  - `actor` object, required — The attribution actor who will run the scheduled pipeline.
    - `avatar_url` string, required — URL to the user's avatar on the VCS
    - `id` string, uuid, required — The unique ID of the user.
    - `login` string, required — The login information for the user on the VCS.
    - `name` string, required — The name of the user.
  - `description` string, required — Description of the schedule.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/circleci/apis/api-v2.md) · [All operations](https://skmtc.net/circleci/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/circleci/api-v2/versions/b9c0e0c24058/schema)