---
title: "List this account's Background Checks"
method: GET
path: "/background-checks"
---

# List this account's Background Checks

`GET /background-checks`

## Request

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

Newest first. Completed rows carry all_clear, total_flags, critical_flags, categories_flagged (titles alongside the count), posts_analyzed and an expiring `pdf_url`. Free; read scope suffices.

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'completed' | 'processing' | 'failed' | 'awaiting_payment' | 'awaiting_consent'

## Response `200`

{ total, count, limit, offset, checks[] }

- object

## Other responses

- `401`: Missing or invalid API key.
- `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)