List Versions Tier 4

GET/api/projects/:id/versionsCopied!

Returns a paginated list of versions for a project.

Request

Path

idstringrequired

Project ID

Query

pagenumber

1–100

Page number

Default: 1

sort.typestring

Sort field

Possible values: namecreatedAt

Default: createdAt

sort.directionstring

Sort direction

Possible values: ascdesc

Default: desc

Response

Returns 200 OK.

dataarray

Versions

data[].idstring

Version ID

Example: 8fe89e5a-1d8f-4302-8437-fb0390ecf8eb

data[].namestring

Version name

Example: v12

data[].descriptionstring?

Version description

Example: Final review cut

data[].statusstring

Review status

Example: NEED_REVIEW

data[].createdAtstring

Version creation date

Example: 2026-04-09 18:00:00.000000

data[].updatedAtstring

Version last updated date

Example: 2026-04-10 02:00:00.000000

data[].projectobject

Parent project

data[].project.idstring

Parent project ID

Example: bdbff5de-96d7-468f-9db0-85fe28bd6b62

pageobject

Pagination

page.currentnumber

Current page number

Example: 1

page.hasNextboolean

Whether more pages exist

Example: false

Example

curl 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/versions' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "id": "8fe89e5a-1d8f-4302-8437-fb0390ecf8eb",
      "name": "v12",
      "description": "Final review cut",
      "status": "NEED_REVIEW",
      "createdAt": "2026-04-09 18:00:00.000000",
      "updatedAt": "2026-04-10 02:00:00.000000",
      "project": {
        "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62"
      }
    }
  ],
  "page": {
    "current": 1,
    "hasNext": false
  }
}

INFO

Restricted reviewers only receive versions explicitly marked for restricted access.