---
title: "Get a schedule summary for a given schedule id"
method: GET
path: "/v1/projects/{projectId}/schedules/{scheduleId}"
tags: ["Schedules"]
---

# Get a schedule summary for a given schedule id

`GET /v1/projects/{projectId}/schedules/{scheduleId}`

An endpoint to get schedule details for a given schedule id

## Path parameters

- `projectId` string, uuid, required
- `scheduleId` string, uuid, required

## Response `200`

Schedule details returned successfully with no errors

- ScheduleSummary
  - `cronExpression` string — Either an intervalExpression or cronExpression must be present for a schedule. This this is formatted in the Quartz format.
  - `cronTimezone` string — The timezone region value used to determine in what timezone the CronExpression is applied. It will be used to in combination with the cronExpression to determine the schedule run times in the specified timezone region.
  - `effectiveFrom` string, date-time — A date time value specifying at what point the schedule becomes effective, before this time the schedule will not run. The format of the date time will be yyyy-MM-dd'T'HH:mm:ssZ and is always returned in UTC
  - `environmentName` string — The environment name to run the pipeline that the schedule is associated with
  - `gridVariables` object — The map of grid variables to be overridden when ETL pipeline is executed
  - `intervalExpression` IntervalExpression
    - `interval` integer
    - `unit` string
  - `lastRunAt` string, date-time — A datetime value for when the schedule last ran. The format of the date time will be yyyy-MM-dd'T'HH:mm:ssZ and is always returned in UTC
  - `name` string — An optional name for the schedule, if not provided then it will constructed from pipelinename_environment_currentTimestamp
  - `nextRunAt` string, date-time — A datetime value for when the schedule should next run. The format of the date time will be yyyy-MM-dd'T'HH:mm:ssZ and is always returned in UTC
  - `pipelineName` string — Name of the pipeline that the schedule is associated with
  - `scalarVariables` object — The map of scalar variables to be overridden when ETL pipeline is executed
  - `scheduleEnabled` boolean — An enabled boolean flag for whether the schedule is enabled.
  - `scheduleId` string — The generated unique schedule Id used to identify a specific schedule
  - `versionName` string — Optional artifact version name of the pipeline that the schedule is associated with

## Other responses

- `400` — Wrong request parameters used
- `401` — Forbidden
- `403` — Unauthorized
- `500` — Unexpected error occurred
- `504` — Gateway timeout

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/versions/6239825f68eb/schema)
