---
title: "List materialization schedules for a workbook"
method: GET
path: "/v2/workbooks/{workbookId}/materialization-schedules"
tags: ["Workbooks"]
---

# List materialization schedules for a workbook

`GET /v2/workbooks/{workbookId}/materialization-schedules`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/workbooks/{workbookId}/materialization-schedules`
- Auth: HTTP bearer

**Attention**: This endpoint will return only paginated responses starting June 2, 2026. To start returning paginated responses before that date, include the query parameter `limit` in your request.

   This endpoint retrieves a list of all materialization schedules associated with a workbook. Each schedule details when and how often specific workbook elements are automatically materialized to optimize performance and data freshness.
   ### Usage notes
   - Retrieve the **workbookId** by calling the [/v2/workbooks](https://help.sigmacomputing.com/reference/list-workbooks) endpoint.
   - To retrieve additional pages of results, use the response of the `nextPage` parameter as the `page` query parameter in the following request.

   ### Usage scenarios
   - **Monitoring and management:** Administrators can monitor and manage the schedules for materialization to ensure optimal system performance.
   - **Audit and review:** Periodic reviews of materialization schedules can help in assessing the efficiency of data processes and making necessary adjustments.

   ### Best practices
   - Regularly review materialization schedules to align them with current data usage patterns and business needs.
   - Use pagination to manage large sets of data and improve response times of API calls.

## Path parameters

- `workbookId` string, required

## Query parameters

- `page` string
- `limit` number, double

## Response `200`

The response body.

- union
  - WorkbooksListMaterializationSchedulesResponse2000
    - `entries` V2WorkbooksWorkbookIdMaterializationSchedulesGetResponsesContentApplicationJsonSchemaOneOf0EntriesItems[], required
      - `sheetId` string, required: Identifier of the materialization schedule for the element
      - `elementId` string, required: Identifier of the element being materialized
      - `elementName` string, required
      - `schedule` V2WorkbooksWorkbookIdMaterializationSchedulesGetResponsesContentApplicationJsonSchemaOneOf0EntriesItemsSchedule, required
        - `cronSpec` string: Cron expression to use for the schedule
        - `timezone` string: Timezone code, for example, PST
      - `configuredAt` string, date-time, required
      - `paused` boolean, required
  - WorkbooksListMaterializationSchedulesResponse2001
    - `entries` V2WorkbooksWorkbookIdMaterializationSchedulesGetResponsesContentApplicationJsonSchemaOneOf1EntriesItems[], required
      - `sheetId` string, required: Identifier of the materialization schedule for the element
      - `elementId` string, required: Identifier of the element being materialized
      - `elementName` string, required
      - `schedule` V2WorkbooksWorkbookIdMaterializationSchedulesGetResponsesContentApplicationJsonSchemaOneOf1EntriesItemsSchedule, required
        - `cronSpec` string: Cron expression to use for the schedule
        - `timezone` string: Timezone code, for example, PST
      - `configuredAt` string, date-time, required
      - `paused` boolean, required
    - `nextPage` string, nullable, required

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)