---
title: "List review submissions (review queue)"
method: GET
path: "/api/v1/production-review/submissions"
tags: ["Production Review"]
---

# List review submissions (review queue)

`GET /api/v1/production-review/submissions`

## Request

- Base URL: `https://numonic.ai`
- URL: `https://numonic.ai/api/v1/production-review/submissions`
- Auth: API key in header `x-api-key`

Newest first. `projectRef` includes submissions on its work items. Superseded iterations are hidden unless `includeSuperseded=true`. Scope `read`.

## Query parameters

- `projectRef` string
- `workItemRef` string
- `state` 'pending' | 'needs_changes' | 'approved'
- `includeSuperseded` 'true' | 'false'
- `cursor` string
- `limit` integer

## Headers

- `X-Tenant-ID` string, uuid: Target tenant UUID. Required when API key has access to multiple tenants.

## Response `200`

A page of submissions

- object
  - `items` ReviewSubmission[], required
    - `ref` string, required
    - `projectRef` string, required
    - `workItemRef` string
    - `title` string, required
    - `media` object, required
      - `versionNumber` integer, required
      - `media` object, required
        - `kind` 'numonic-asset', required
        - `assetH` string, required
      - `numonicAssetH` string
    - `state` 'pending' | 'needs_changes' | 'approved', required
    - `submittedBy` object, required
      - `displayName` string, required
      - `numonicAgentId` string
    - `submittedAt` string, required
    - `supersedes` string
    - `decisions` object[], required
      - `outcome` 'needs_changes' | 'approved', required
      - `decidedBy` object, required
        - `displayName` string, required
        - `numonicAgentId` string
      - `decidedAt` string, required
    - `externalRefs` unknown[], required
      - unknown
  - `nextCursor` string, nullable, required

## Other responses

- `400`: Validation failed or Idempotency-Key missing
- `401`: Unauthorized
- `403`: Insufficient scope or role

---

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