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

# Get Spreadsheet Job Provenance

`GET /api/spreadsheets/{runId}/provenance`

## Request

- Base URL: `https://api.shortcut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.shortcut.ai/api/spreadsheets/{runId}/provenance`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - API key in cookie `shortcut_access_token`
  - HTTP bearer

Read the execution provenance of a run you own: what it was given and which builds served it. Contains ids and digests only, never prompt or workbook content.

## Path parameters

- `runId` string, required

## Response `200`

Default Response

- object
  - `runId` string, required
  - `sourceCache` object[], required: Source extraction cache outcomes: hit/miss reason, immutable source/processor identity, lookup time and reused stage ids.
    - `fileId` string, required
    - `stage` 'retrieval' | 'extraction', required
    - `status` 'hit' | 'miss' | 'bypass', required
    - `stageId` string, uuid, required
    - `reusedStageId` string, uuid
    - `published` unknown, required
    - `reason` string
    - `lookupMs` number
    - `sourceVersion` string
    - `processorVersion` string
  - `manifest` object, required: Immutable execution manifest recorded when the run was dispatched: input generations and digests, skill ids, prompt/config digests, requested and effective model and effort, API build, and requested output contract. The validation field does not identify an executed validator or prove validation ran. Null when the run has no manifest.
  - `resolutions` object[], required: Facts resolved after dispatch, such as the MOG build the sandbox reported.
  - `unknown` string[], required: Fields unknown when the immutable manifest was captured. Later resolutions may supersede entries without changing this list; consult resolutions for facts learned afterward. Contains 'manifest' when no manifest is available; never filled with defaults.

## Changes

- **2026-10-22** `6dff11e9d66b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shortcut/apis/shortcut-api/changes/api/spreadsheets/:runId/provenance/get.md)

---

[API](https://skmtc.dev/shortcut/apis/shortcut-api.md) - [All operations](https://skmtc.dev/shortcut/apis/shortcut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shortcut/apis/shortcut-api/revisions/4ae382e2c957?raw)