---
title: "List runs for a collection"
method: GET
path: "/webdbs/collections/{collection_id}/runs"
tags: ["webdbs"]
---

# List runs for a collection

`GET /webdbs/collections/{collection_id}/runs`

Returns recent runs for a collection.

## Path parameters

- `collection_id` string, required — Collection ID.

## Query parameters

- `limit` integer — Maximum items to return. Defaults to 25.
- `cursor` string — Pagination cursor from a previous response.
- `tags` string[] — Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

## Response `200`

A paginated list of runs, newest first

- WebdbsListRunsResponse — A page of collection runs.
  - `data` WebdbsRun[], required — Runs in this page.
    - `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.
  - `has_more` boolean, required — Whether another page is available.
  - `next_cursor` string, nullable, required — Cursor for the next page, or null at the end.
  - `key_metadata` object — API key usage for this request.
    - `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/182f532c2552/schema)