TracePass
Get started
DPP scope check

Get catalogue run status

Returns the status and evaluation counts for one catalogue scope run. Poll this endpoint after `POST /api/v1/scope/catalogue/runs` until `status` is `done` or `failed`. Once done, the fresh results are available via `GET /api/v1/scope/catalogue`. A run belonging to another company returns 404.

GET/api/v1/scope/catalogue/runs/{id}
Download OpenAPI 3.1
GET/api/v1/scope/catalogue/runs/{id}

Get catalogue run status

Returns the status and evaluation counts for one catalogue scope run. Poll this endpoint after `POST /api/v1/scope/catalogue/runs` until `status` is `done` or `failed`. Once done, the fresh results are available via `GET /api/v1/scope/catalogue`. A run belonging to another company returns 404.

Requires Growth or higher (`scopeCatalogueEnabled`). Does not count against daily caps.

Path parameters

  • idrequired

    string

    The run ID from `POST /api/v1/scope/catalogue/runs`.

    e.g. 6728abc123def456789abcde

Headers

  • Authorizationrequired

    string

    `Bearer <token>` — either a `tp_` API key (Developer → API Keys; simplest, for server-to-server) or an OAuth 2.0 access token (Developer → OAuth Apps; for user-authorized apps, scoped + revocable). The Authentication page has the full OAuth flow and scope list.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Request

curl -sS https://app.tracepass.eu/api/v1/scope/catalogue/runs/6728abc123def456789abcde \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Response

{
  "id": "6acbb533c5553f06d833479e",
  "trigger": "manual",
  "status": "done",
  "rulesFingerprint": "86a23cce6480bffb91d360b7a199b473",
  "counts": { "evaluated": 1, "distinctFactSets": 1, "changed": 1, "removed": 0, "answersChanged": 0 },
  "createdAt": "2026-10-11T16:11:31.583Z",
  "startedAt": "2026-10-11T16:11:31.588Z",
  "finishedAt": "2026-10-11T16:11:31.619Z",
  "error": null
}

Related endpoints