# Fetch a schedule

This operation shows the details of a specific schedule.

Endpoint: GET /schedules/{id}
Version: v2.0

## Path parameters:

  - `id` (string, required)
    The unique alphanumeric string that identifies the schedule.

## Response 200 fields (application/json):

  - `schedule` (object, required)
    Example: {"id":"28bwb5WT","state":"disabled","name":"Scheduled recurring start for my camera","time_zone":"America/New_York","transcoder_id":"VGB21JFJ","transcoder_name":"My Camera","recurrence_type":"recur","recurrence_data":"monday,tuesday,wednesday,thursday,friday","action_type":"start_stop","start_transcoder":"2020-02-01T00:00:00.000Z","stop_transcoder":"2020-02-29T23:59:59.999Z","start_repeat":"2020-02-01T00:00:00.000Z","end_repeat":"2020-02-29T00:00:00.000Z","created_at":"2020-01-29T17:16:21.995Z","updated_at":"2020-01-31T07:00:48.995Z"}

  - `schedule.action_type` (string)
    The type of action that the schedule should trigger on the transcoder. The default is start.
    Enum: "start", "stop", "start_stop"

  - `schedule.created_at` (string)
    The date and time that the schedule was created.
    Example: "2020-01-29T17:16:21.995Z"

  - `schedule.end_repeat` (string)
    The month, day, and year that a recurring schedule should stop running. Specify YYYY-MM-DD.
    Example: "2020-02-29T00:00:00.000Z"

  - `schedule.id` (string)
    The unique alphanumeric string that identifies the schedule.
    Example: "28bwb5WT"

  - `schedule.name` (string)
    A descriptive name for the schedule. Maximum 255 characters.
    Example: "Scheduled recurring start for my camera"

  - `schedule.recurrence_data` (string)
    The day or days of the week that a recurring schedule should run.
    Enum: "sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"

  - `schedule.recurrence_type` (string)
    A schedule can run one time only (once) or repeat (recur) until a specified end_repeat date. The default is once.
    Enum: "once", "recur"

  - `schedule.start_repeat` (string)
    The month, day, and year that the recurring schedule should go into effect. Specify YYYY-MM-DD.
    Example: "2020-02-01T00:00:00.000Z"

  - `schedule.start_transcoder` (string)
    The month, day, year, and time of day that the action_type start should occur. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC.
    Example: "2020-02-01T00:00:00.000Z"

  - `schedule.state` (string)
    A schedule must be enabled to run. Specify enabled to run the schedule or disabled to turn off the schedule so that it doesn't run.
    Enum: "enabled", "disabled", "expired"

  - `schedule.stop_transcoder` (string)
    The month, day, year, and time of day that the action_type stop should occur. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC.
    Example: "2020-02-29T23:59:59.999Z"

  - `schedule.time_zone` (string)
    The time zone the schedule runs in.
    Example: "America/New_York"

  - `schedule.transcoder_id` (string)
    The unique alphanumeric string that identifies the transcoder being scheduled.
    Example: "VGB21JFJ"

  - `schedule.transcoder_name` (string)
    The name of the transcoder being scheduled.
    Example: "My Camera"

  - `schedule.updated_at` (string)
    The date and time that the schedule was updated.
    Example: "2020-01-31T07:00:48.995Z"

## Response 401 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 403 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 404 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 410 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)