---
title: "Get a run"
method: GET
path: "/webdbs/runs/{run_id}"
tags: ["webdbs"]
---

# Get a run

`GET /webdbs/runs/{run_id}`

Returns the status and results of one collection run.

## Path parameters

- `run_id` string, required — Run ID.

## Query parameters

- `tags` string[] — Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

## Response `200`

Run

- object — Status and results for a sync, reprocess, or purge action.
  - `id` string, required — Run ID.
  - `collection_id` string, required — Collection ID.
  - `status` 'queued' | 'running' | 'completed' | 'partial' | 'failed' | 'skipped', required — Current run status.
  - `trigger` 'initial' | 'scheduled' | 'manual' | 'reprocess' | 'purge', required — Action that started the run.
  - `stats` object, required — Run totals.
    - `pages_fetched` integer, required — Pages fetched during the run.
    - `eligible` integer, required — Pages accepted as rows.
    - `rejected` integer, required — Pages rejected by eligibility rules.
    - `rows_created` integer, required — Rows created during the run.
    - `rows_updated` integer, required — Rows updated during the run.
    - `rows_unchanged` integer, required — Rows that did not change.
    - `rows_removed` integer, required — Rows marked as removed.
    - `rows_errored` integer, required — Rows that could not be processed.
    - `rows_capped` integer, required — Rows paused by a credit limit.
    - `credits_consumed` integer, required — Credits used by the run.
  - `by_target` object[], required — Results for each target.
    - `target_id` string, required — Target ID.
    - `coverage` 'full' | 'truncated', required — Whether the target finished every planned page.
    - `pages_fetched` integer, required — Pages fetched from this target.
    - `errors` integer, required — Errors from this target.
  - `errors` object[], required — Errors grouped by type.
    - `type` string, required — Error type.
    - `count` integer, required — Number of errors of this type.
  - `capped_url_count` integer, required — URLs skipped because a credit limit was reached.
  - `skip_reason` 'insufficient_credits' | 'collection_paused' | 'superseded' | 'null', nullable, required — Why a skipped run did not start.
  - `error` WebdbsRunError — Error reported by a collection run.
    - `code` string, required — Machine-readable error code.
    - `message` string, required — Human-readable error message.
  - `started_at` string, date-time, nullable, required — Time the run started.
  - `completed_at` string, date-time, nullable, required — Time the run finished.
  - `created_at` string, date-time, required — Time the run was created.
  - `key_metadata` KeyMetadata — Metadata about the API key used for the request. Included in every response whenever a valid API key is provided, even when the response status is not 200.
    - `credits_consumed` integer, required — The number of credits consumed by this request.
    - `credits_remaining` integer, required — The number of credits remaining for your organization after this request.

## Other responses

- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/context/apis/context-dev.md) · [All operations](https://skmtc.net/context/apis/context-dev/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/context/context-dev/versions/3c6a01ba967f/schema)