Skip to main content

Review Stats

Get review queue statistics with GET /v1/review/stats: total record count plus a by_status breakdown for monitoring backlog size and review throughput.

GET /v1/review/stats returns a summary of the Record Review queue: the total number of validation records and a by_status breakdown (pending, approved, rejected). Use it to monitor backlog size, track review throughput, and trigger alerts when pending items exceed a threshold.

The by_status.pending count is the live human-review backlog. total includes already-approved and rejected records, so it grows monotonically and is better suited to throughput dashboards than alerting.
GET/v1/review/stats

Response

Response fields

totalintegerTotal number of review records across all statuses.
by_statusobjectCount of records keyed by status (e.g. pending, approved, rejected).

Response

{
  "total": 260,
  "by_status": {
    "pending": 15,
    "approved": 230,
    "rejected": 15
  }
}

Errors

Error responses

401unauthorizedMissing or invalid API key.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

This endpoint is typically called on a dashboard polling loop to drive queue-depth indicators. Pair it with GET /v1/review filtered by status=pending to fetch the actual items once the pending count crosses your alerting threshold.

Related

List Review Items
Batch Review Actions
Approve or Reject an Item