---
title: "Get a materialization job"
method: GET
path: "/v2/workbooks/{workbookId}/materializations/{materializationId}"
tags: ["Workbooks"]
---

# Get a materialization job

`GET /v2/workbooks/{workbookId}/materializations/{materializationId}`

## Request

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

This endpoint retrieves details of a specific materialization job associated with a workbook by materializationId. It provides comprehensive information including status, start and completion times, which helps for monitoring and troubleshooting materialization.

### Usage notes
- Retrieve the **materializationId** by calling the [/v2/workbooks/{workbookId}/materializations](https://help.sigmacomputing.com/reference/materialize-workbook-element) endpoint.

### Usage scenarios
- **Job Monitoring:** Enables administrators to track the progress and status of materialization jobs, aiding in operational oversight.
- **Troubleshooting:** Provides detailed information needed to diagnose and resolve issues in materialization processes.

### Best practices
- Monitor materialization jobs regularly to detect and resolve issues promptly.
- Use the detailed information provided by this endpoint to optimize materialization settings and performance.

## Path parameters

- `workbookId` string, required
- `materializationId` string, required

## Response `200`

The response body.

- WorkbooksGetWorkbookMaterializationResponse200
  - `materializationId` string, required
  - `status` string, required
  - `startedAt` string, date-time
  - `readyAt` string, date-time
  - `expiredAt` string, date-time
  - `error` 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)