---
title: "Get a review submission"
method: GET
path: "/api/v1/production-review/submissions/{submissionRef}"
tags: ["Production Review"]
---

# Get a review submission

`GET /api/v1/production-review/submissions/{submissionRef}`

## Request

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

## Path parameters

- `submissionRef` string, required: URL-encoded submission reference `native:<40-hex>` (EntityRef wire form)

## Response `200`

The submission with its decision history (newest first)

- ReviewSubmission: `state` is derived: the latest decision outcome, else `pending`. A resubmission is a new submission with `supersedes` and the next `versionNumber`.
  - `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

## Other responses

- `400`: Validation failed or Idempotency-Key missing
- `401`: Unauthorized
- `403`: Insufficient scope or role
- `404`: Not found in this tenant

---

[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)