---
title: "Track an enrichment run (incl. per-row upsert outcomes)"
method: GET
path: "/enrichment-runs/{runId}"
tags: ["Workspace"]
---

# Track an enrichment run (incl. per-row upsert outcomes)

`GET /enrichment-runs/{runId}`

Run status, row count, enrichment counts, credits used, and — for
`upsert`-type runs — the per-row `outcomes[]` ledger plus
`outcomeCounts`. `GET /batches/{batchId}` is the deprecated alias.

## Response `200`

The enrichment-run detail.

- EnrichmentRunDetail — A tracked batch of column-over-row work on a table (upserts, file ingests). `id` is canonical; `batchId` is the kept legacy alias (identical value).
  - `object` 'enrichment_run', required
  - `id` string, uuid, required
  - `batchId` string, uuid, required — Legacy alias of `id` — kept for pre-restructure consumers.
  - `tableId` string, uuid, required
  - `type` string, required — The run's work type (e.g. `upsert`).
  - `status` string, required
  - `createdAt` string, date-time, required
  - `completedAt` string, date-time, nullable, required
  - `rowCount` integer, required — Rows this run processed. For `upsert` runs this is the per-row outcome ledger length (one entry per input row).
  - `enrichments` object, required
    - `total` integer, required
    - `completed` integer, required
    - `pending` integer, required
    - `failed` integer, required
  - `creditsUsed` integer, required — Settled credit cost. `0` until the run reaches a terminal status.
  - `outcomes` object[] — Present only on `upsert`-type runs — the per-row outcome ledger.
    - `inputIndex` integer, required
    - `rowId` string, uuid, nullable, required
    - `outcome` 'inserted' | 'updated' | 'skipped', required
  - `outcomeCounts` object — Present only on `upsert`-type runs.
    - `inserted` integer, required
    - `updated` integer, required
    - `skipped` integer, required

## Other responses

- `404` — BATCH_NOT_FOUND — enrichment run not found.

---

[API](https://skmtc.net/origami/apis/origami-agent-api.md) · [All operations](https://skmtc.net/origami/apis/origami-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/origami/origami-agent-api/versions/8083ad7fe081/schema)