---
title: "Get Spreadsheet Job Status"
method: GET
path: "/api/spreadsheets/{runId}"
tags: ["Spreadsheets"]
---

# Get Spreadsheet Job Status

`GET /api/spreadsheets/{runId}`

Check the status of a spreadsheet processing job. Returns queued, running, finalizing, completed, failed, or cancelled status.

## Path parameters

- `runId` string, required

## Response `200`

Default Response

- union
  - object
    - `runId` string, required — Unique run identifier
    - `status` 'completed', required — Job completed successfully
    - `downloadUrl` string — URL to download the result workbook, present when the completed job produced a workbook. Ask-mode jobs may complete with only a summary.
    - `summary` string — Final AI message summary from the agent
    - `artifacts` string[], required — Filenames of files produced by the job. Download via GET /api/spreadsheets/:runId/artifacts/:filename
  - object
    - `runId` string, required — Unique run identifier
    - `status` 'queued' | 'running' | 'finalizing', required — Job is still active
    - `artifacts` string[] — Filenames of currently available run artifacts, including live debug snapshots when debug mode is enabled.
  - object
    - `runId` string, required — Unique run identifier
    - `status` 'failed' | 'cancelled', required — Job failed or was cancelled
    - `error` string, required — Error message
    - `downloadUrl` string — URL to download a partial result workbook when a timeout saved one.
    - `artifacts` string[] — Filenames of currently available run artifacts, including failure debug artifacts when debug mode is enabled.

## Other responses

- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/shortcut/apis/shortcut-api.md) · [All operations](https://skmtc.net/shortcut/apis/shortcut-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shortcut/shortcut-api/revisions/1d5c69423568/schema)