---
title: "Retrieve structured sheet"
method: GET
path: "/v1/structured-sheets/{structured_sheet_id}"
tags: ["Structured Sheets"]
---

# Retrieve structured sheet

`GET /v1/structured-sheets/{structured_sheet_id}`

Get the status and details of a structured sheet conversion.

## Path parameters

- `structured_sheet_id` string, required — The unique identifier of the structured sheet conversion.

## Response `200`

Successful Response

- StructuredSheetResponse — Response representing a structured sheet conversion job. This is returned from POST (create), GET (retrieve), and list endpoints.
  - `id` string, required — The unique identifier for this structured sheet conversion.
  - `object` 'structured_sheet', required — The object type, which is always 'structured_sheet'.
  - `file_id` string, required — The unique identifier for the source file.
  - `status` 'queued' | 'in_progress' | 'completed' | 'failed' | 'cancelled', required — Status of processing for structured sheets. - queued: Job is queued and waiting to be processed - in_progress: Job is currently being processed - completed: Processing finished successfully - failed: Processing encountered an error - cancelled: Processing was cancelled by the user
  - `last_error` ProcessingError — Error information when processing fails.
    - `code` string, required — A machine-readable error code.
    - `message` string, required — A human-readable description of the error.
  - `table_count` integer, nullable — Number of tables extracted from the workbook. Only present when status is 'completed'.
  - `created_at` string, date-time, required — The timestamp when the conversion was started.
  - `updated_at` string, date-time, required — The timestamp when the conversion was last updated.
  - `sheet_names` string[] — List of sheet names included in this conversion.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Content
- `429` — Too Many Requests

## Changes

- **2026-01-30** `343b87354807` — 2 info
  - the response property `object` became required for the status `200`
  - the `object` response's property default value `structured_sheet` was removed for the status `200`

[Change history](https://skmtc.dev/deeptable-com/apis/deeptable-api/changes/v1/structured-sheets/:structured_sheet_id/get.md)

---

[API](https://skmtc.dev/deeptable-com/apis/deeptable-api.md) · [All operations](https://skmtc.dev/deeptable-com/apis/deeptable-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deeptable-com/deeptable-api/revisions/acfb7545d197/schema)