---
title: "List Review Queue"
method: GET
path: "/v3/review-queue"
tags: ["Review Queue"]
---

# List Review Queue

`GET /v3/review-queue`

**List entities awaiting curation, for a human reviewer's queue.**

Returns a cursor-paginated set of entities scoped to your
account+environment (and optional `bucket`), each carrying a small preview
of its first mentions so a reviewer can triage without opening every
entity. All filters AND together.

- **`status`** (repeatable) restricts to the given lifecycle states.
Omitting it defaults to the pre-terminal states `extracted` and
`proposed`.
- **`type`** (repeatable, `ety_...` IDs) matches the entity's *effective*
type: an entity matches when its assigned type is one of these IDs, or it
has no assigned type and its bem-inferred type name matches one of them.
- **`assignedTo`** (`me` or a `usr_...` ID) restricts to entities whose
effective type the given user reviews. `me` resolves to the calling user.
- **`since`** (RFC3339) restricts to entities created at or after the time.

Pagination is cursor-based on `entityID` ascending; default limit is 50,
maximum 200.

## Query parameters

- `status` string[]
- `type` string[]
- `assignedTo` string
- `since` string
- `cursor` string
- `bucket` string
- `limit` integer

## Response `200`

The request has succeeded.

- ReviewQueueResponseV3 — `GET /v3/review-queue` response. Cursor-paginated by `entityID` ascending.
  - `entities` ReviewQueueEntityV3[], required — The page of entities awaiting curation.
    - `entityID` string, required — Public ID (`ent_...`) of the entity.
    - `canonical` string, required — The canonical (longest / most descriptive) surface form.
    - `type` string, required — The effective type name (assigned override if set, else bem-inferred).
    - `description` string — Free-form description of the entity, when present.
    - `mentionCount` integer, required — Total mentions across all parsed documents.
    - `surfaceForms` string[], required — Distinct surface forms that have resolved to this entity.
    - `createdAt` string, date-time, required — When the entity was created.
    - `updatedAt` string, date-time, required — When the entity was last updated.
    - `status` string, required — Curation lifecycle state: `extracted`, `proposed`, `approved`, `rejected`.
    - `typeID` string — Public ID (`ety_...`) of the customer-assigned type, when one is set.
    - `validatedAt` string, date-time — When a human approved/rejected the entity. Omitted while un-validated.
    - `validatedByUserID` string — Public ID (`usr_...`) of the user who validated the entity, when known.
    - `previewMentions` ReviewQueueMentionV3[], required — A capped preview (up to 2) of the entity's first mentions, ordered by page then time, so a reviewer can triage without opening each entity.
      - `mentionID` string, required — Public ID (`emn_...`) of this mention.
      - `entityID` string, required — Public ID (`ent_...`) of the entity this mention resolves to.
      - `referenceID` string, required — The user-provided document handle this mention came from.
      - `transformationID` string — Public ID of the parse transformation that produced this mention, when known.
      - `page` integer, required — 1-indexed page number within the source document.
      - `sectionLabel` string — The parse-emitted section label this mention sat under, when present.
      - `surface` string, required — The exact surface string Parse extracted on the page.
      - `createdAt` string, date-time, required — When this mention was recorded.
  - `hasMore` boolean, required — Whether more rows exist beyond this page.
  - `nextCursor` string — Opaque cursor to pass as `?cursor=` for the next page. Empty when `hasMore` is false.

## Changes

- **2026-06-17** `d7092283f192` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bem-team/apis/bem-api/changes/v3/review-queue/get.md)

---

[API](https://skmtc.dev/bem-team/apis/bem-api.md) · [All operations](https://skmtc.dev/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bem-team/bem-api/revisions/643398900e5d/schema)