---
title: "Poll a Background Check — full categorized report with evidence (JSON or PDF)"
method: GET
path: "/background-checks/{id}"
---

# Poll a Background Check — full categorized report with evidence (JSON or PDF)

`GET /background-checks/{id}`

## Request

- Base URL: `https://creatorscore.io/api/v1`
- URL: `https://creatorscore.io/api/v1/background-checks/{id}`
- Auth: API key in header `X-API-Key`

Status of a Social Background Check and, when completed, the FULL report the dashboard shows: `report.categories[]` (Hate Speech, NSFW, Violence, Profanity, Political, Legal, Public Feuds, Brand Criticism, Substance, Deceptive, …) each with its flags — description, content_preview (caption/transcript excerpt), post_url, detected_at, risk_weight ('risk' counted vs 'context' shown-only), Wayback-recovery marker for deleted content, and an `evidence` object with signed thumbnail + flagged-frame links; `summary` with categories_clean, categories_unassessed (+ reason), coverage gaps, content window and archive_timeline; `flags[]` (flat, backward-compatible, now with evidence); `pdf_url` (expiring browser-openable PDF); `dashboard_url`. Reviewer-dismissed findings are excluded. `?format=pdf` streams the PDF. NO SCORE — a Background Check is a brand-safety inspection, a separate product from the CreatorScore. Free to read; read scope suffices. A check owned by another tenant returns 404.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `format` 'json' | 'pdf'

## Response `200`

completed (report attached) / awaiting_payment / awaiting_consent / failed.

- object

## Other responses

- `202`: processing — poll again in ~30s (progress + progress_message).
- `401`: Missing or invalid API key.
- `404`: Not found on this account.
- `429`: Per-key rate limit hit (120 req/min). Retry after the duration in the Retry-After header.

---

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