---
title: "Retrieve all versions for the specified authoring item."
method: GET
path: "/authoring/v1/versions/{classification}/{id}"
tags: ["Authoring version"]
---

# Retrieve all versions for the specified authoring item.

`GET /authoring/v1/versions/{classification}/{id}`

Use the /versions/{classification}/{id} endpoint to retrieve all the versions for the specified authoring item.
<br />User roles: admin, manager, editor, viewer

## Path parameters

- `id` string, required
- `classification` string, required

## Response `200`

Successfully retrieved the API representation containing all the versions for the specified item.

- object — All versions for the specified item.
  - `id` string, required — The id of the item that these versions belong to
  - `classification` string, required — the classification of the item these versions belong to
  - `deleted` boolean, required — Whether the specified item is currently deleted.
  - `versions` object[], required — The published versions associated to the specified item.
    - `containerType` 'deleted' | 'current' | 'item' — This indicates identifies the format of this container object in this API. "deleted" represents a deleted version so it won't have a link to the actual document. "item" represents the standard version and "current" is to collect draft versions
    - `number` string — The major version number
    - `link` string — A link to fetching the actual version, only available for containerType "item"
    - `timestamp` string, date-time — ISO-8601 timestamp of when the version was created. Also serves as the unique identifier for the version. Not available for containerType "current"
    - `user` string — The display name of the user that created this version
    - `userId` string — The user identifier of the user that created this version
    - `drafts` object[] — the draft versions that were made leading up to this published ersion.
      - `containerType` 'deleted' | 'item' — This indicates identifies the format of this container object in this API. "deleted" represents a deleted version so it won't have a link to the actual document. "item" represents the standard version
      - `number` string — The minor version number
      - `link` string — A link to fetching the actual version, only available for containerType "item"
      - `timestamp` string, date-time — ISO-8601 timestamp of when the version was created. Also serves as the unique identifier for the version.
      - `user` string — The display name of the user that created this version
      - `userId` string — The user identifier of the user that created this version
      - `event` 'published' | 'created' | 'updated' | 'retired' | 'approved' | 'restored' | 'deleted' | 'merged' | 'moved-source' | 'moved-target' | 'review-started' | 'review-ended' — Version Event: * `published` - Published, The item was published and the `ready` item was updated * `created` - Created, The item was created * `updated` - Updated, the item was updated * `retired` - Retired, the item was retired * `approved` - Approved, the draft item was approved * `restored` - Restored, this item update is based off a previous version * `deleted` - Deleted, the item was deleted * `merged` - Merged, this draft was deleted and its changes was merged into the `ready` item * `moved-source` - Deleted by Move, This draft was deleted as it was moved into a project/publishing job * `moved-target` - Created by Move, this draft was created in this particular project/publishing job as a result of a move * `review-started` - Start Review, a review was started on this item * `review-ended` - Review Ended, a review was ended on this item
    - `event` 'published' | 'created' | 'updated' | 'retired' | 'approved' | 'restored' | 'deleted' | 'merged' | 'moved-source' | 'moved-target' | 'review-started' | 'review-ended' — Version Event: * `published` - Published, The item was published and the `ready` item was updated * `created` - Created, The item was created * `updated` - Updated, the item was updated * `retired` - Retired, the item was retired * `approved` - Approved, the draft item was approved * `restored` - Restored, this item update is based off a previous version * `deleted` - Deleted, the item was deleted * `merged` - Merged, this draft was deleted and its changes was merged into the `ready` item * `moved-source` - Deleted by Move, This draft was deleted as it was moved into a project/publishing job * `moved-target` - Created by Move, this draft was created in this particular project/publishing job as a result of a move * `review-started` - Start Review, a review was started on this item * `review-ended` - Review Ended, a review was ended on this item

## Other responses

- `404` — No versions found for item with ID {id} and classification {classification}.
- `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 specified item's versions 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/revisions/677305266d89/schema)