Get Version Tier 4

GET/api/versions/:idCopied!

Returns a single version.

Request

Path

idstringrequired

Version ID

Response

Returns 200 OK.

dataobject

Version

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 (see table below)

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

Example

curl 'https://api.youvico.com/api/versions/8fe89e5a-1d8f-4302-8437-fb0390ecf8eb' \
  -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"
    }
  }
}

The status field is one of:

Value	Description
IN_PROGRESS	Being worked on
NEED_REVIEW	Ready for review
NEED_EDIT	Reviewer requested changes
ON_HOLD	Paused
APPROVED	Approved
REJECTED	Rejected
CLOSED	Closed