---
title: "List materialization schedules for a data model"
method: GET
path: "/v2/dataModels/{dataModelId}/materializationSchedules"
tags: ["Data models"]
---

# List materialization schedules for a data model

`GET /v2/dataModels/{dataModelId}/materializationSchedules`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/dataModels/{dataModelId}/materializationSchedules`
- Auth: HTTP bearer

This endpoint retrieves a list of all materialization schedules associated with a data model. Each schedule details when and how often specific data model elements are automatically materialized to optimize performance and data freshness.
  ### Usage notes
  - Retrieve the **dataModelId** by calling the [/v2/dataModels](https://help.sigmacomputing.com/reference/list-data-models) endpoint.
  - To retrieve additional pages of results, use the response of the `nextPageToken` parameter as the `pageToken` 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

- `dataModelId` string, required

## Query parameters

- `pageToken` string
- `pageSize` integer

## Response `200`

The response body.

- DataModelsListDataModelMaterializationSchedulesResponse200
  - `entries` V2DataModelsDataModelIdMaterializationSchedulesGetResponsesContentApplicationJsonSchemaEntriesItems[], required: Array of results returned by the endpoint
    - `sheetId` string, required: Identifier of the materialization schedule for the element
    - `elementId` string, required: Identifier of the element being materialized
    - `elementName` string, required
    - `schedule` V2DataModelsDataModelIdMaterializationSchedulesGetResponsesContentApplicationJsonSchemaEntriesItemsSchedule, 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
  - `nextPageToken` string: A string that can be passed to the `pageToken` parameter in the next request to fetch the next page of results. Not present in the last page of results. **Must be treated as an opaque string.**

---

[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)