---
title: "Retrieve an existing review."
method: GET
path: "/authoring/v1/review/{id}"
tags: ["Authoring review"]
---

# Retrieve an existing review.

`GET /authoring/v1/review/{id}`

Use the /review/{id} endpoint to retrieve an existing review that matches the ID that is specified from the database. This endpoint returns the API representation of the requested review.
<br />User roles: admin, manager, editor, viewer

## Path parameters

- `id` string, required

## Response `200`

Successfully retrieved the API representation for the existing review that matches the ID that you provided.

- object
  - `id` string, required — The ID of the review.
  - `rev` string, required — The current revision of the review.
  - `classification` string — The review's classification.
  - `name` string, required — The name of the review.
  - `targetDate` string, date-time — Optional. Set a target date for when the review is due and must end.
  - `status` 'active' | 'complete' — The status of a review. The initial status of a review is active, changed to complete when it is ended.
  - `approvalStatus` 'approved' | 'not-approved' — The approval status of a review. The initial status of a review is not-approved, changed to approved when all items has been approved.
  - `completed` string, date-time — The completed date of this review in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
  - `approvers` object[] — Approvers' user ID for the review.
    - `id` string
  - `approvals` object[] — Approvals for a review.
    - `user` object — A user object with user ID.
      - `id` string
    - `date` string, date-time — The approved date in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
    - `items` object[] — The ID of the items that been approved in a approval.
      - `id` string
      - `classification` 'asset' | 'content' — The classification of the item.
  - `rejections` object[] — Rejections for a review.
    - `user` object — A user object with user ID.
      - `id` string
    - `date` string, date-time — The approved date in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
    - `items` object[] — The ID of the items that been rejected in a rejection.
      - `id` string
      - `classification` 'asset' | 'content' — The classification of the item.
  - `items` object[] — Provide the ID of the items that you want to submit for review. The unique ID (uid) is the items classification and the ID combined to create an ID that is unique across all content hub items.
    - `id` string
    - `classification` 'asset' | 'content' — The classification of the item.
  - `lastModified` string, date-time — The last modified date of this review in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
  - `lastModifierId` string — The ID of the user that last modified the review.
  - `created` string, date-time — The created date of this review in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
  - `creatorId` string — The ID of the creator of the review.

## Other responses

- `404` — The review with ID {id} was not found.
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
- `503` — Unable to retrieve the review from the database as the service is unavailable. Try again later.
- `default` — Unexpected error.

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/versions/677305266d89/schema)