---
title: "Read current backlog and period screening and reviewer activity"
method: GET
path: "/reports"
tags: ["Reports"]
---

# Read current backlog and period screening and reviewer activity

`GET /reports`

## Request

- Base URL: `https://www.sanctionskit.com/api/v1`
- URL: `https://www.sanctionskit.com/api/v1/reports`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sanctionskit/apis/sanctionskit-api/docs/reports/get.ts> (a function with typed inputs; its response is checked against the schema)

Required API key scope: results:read.

Open, overdue, unassigned and pending-approval cases are the current backlog across all dates; screenings, completed case cohorts and human review activity use the selected period. Superseded cases are excluded from active work. Renewed reviews measure time from their latest review cycle.

## Query parameters

- `from` string, date
- `to` string, date
- `timeZone` string

## Response `200`

Successful response. JSON object with the required data key. All properties marked required are present, including keys whose value may be null. Unmarked properties can be omitted; clients should tolerate additional response properties.

- object
  - `data` OperationsReport, required
    - `timeZone` string, required: Captured calendar timezone used for this report range.
    - `from` string, required
    - `to` string, required
    - `generatedAt` string, date-time, required
    - `screenings` object, required
      - `total` integer, required
      - `potentialMatches` integer, required
      - `noMatches` integer, required
      - `expired` integer, required
    - `cases` object, required
      - `open` integer, required
      - `confirmed` integer, required
      - `dismissed` integer, required
      - `overdue` integer, required
      - `pendingApproval` integer, required
      - `unassigned` integer, required
    - `monitoring` object, required
      - `active` integer, required
      - `paused` integer, required
      - `overdue` integer, required
      - `failed` integer, required
      - `unread` integer, required
    - `reviews` object, required
      - `total` integer, required
      - `reused` integer, required
      - `medianHours` number, nullable, required
    - `reviewers` object[], required
      - `actorId` string, required
      - `actorEmail` string
      - `decisions` integer, required
    - `sourceCoverage` object[], required
      - `sourceId` string, required
      - `screenings` integer, required
    - `expiringEvidence` object[], required
      - `screeningId` string, uuid, required
      - `expiresAt` string, date-time, required
      - `caseId` string, uuid, nullable, required
    - `limitations` string[], required

## Other responses

- `400`: **invalid_request** — Correct the request fields, resource identifiers, JSON body or query parameters before retrying. **invalid_date_range** — Use valid inclusive from/to calendar dates in the selected timezone, with from no later than to.
- `401`: **authentication_required** — Send Authorization: Bearer with a valid API key. An omitted header can produce authentication_required; invalid supplied credentials produce invalid_api_key. **invalid_api_key** — Use an active key for the intended environment.
- `403`: **permission_denied** — Ask an organization owner to grant the required role or API-key scope. **insufficient_scope** — Use a key with the scope stated in this operation.
- `405`: **method_not_allowed** — Use a method in the Allow response header. OPTIONS lists supported methods; HEAD follows GET authorization and returns no body.
- `413`: **response_too_large** — Reduce the requested page size or use the documented segmented case archive. No evidence is silently truncated.
- `429`: **rate_limited** — Wait for the request window to reset and retry with backoff.
- `500`: **internal_error** — Retry with backoff. For writes reuse the same idempotency key and identical input; include requestId when contacting support.
- `503`: **temporarily_unavailable** — Honor Retry-After when present and retry with bounded backoff. Follow this endpoint’s retry contract; preserve the same key and input for idempotent writes. Contact support with requestId if the failure persists.

---

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