Docs

Get File Version

GET /drives/{eventId}/files/{fileId}/versions/{versionId}

GET/drives/{eventId}/files/{fileId}/versions/{versionId}

Required Tokens

FieldTypeRequiredDescription
BearerAuthorization: Bearer <api-key>OptionalYour API key. Pass it as the Bearer token on every request.
Event tokenx-Event-TokenOptionalRun **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually.

Returns the full details of a specific file version, including its comments, reviews, and all uploaded formats with download URIs. Requires at least File.Read permission on the file's path.

Path Parameters

FieldTypeRequiredDescription
driveIdGuidRequiredThe event ID.
fileIdGuidRequiredThe file ID.
versionIdGuidRequiredThe version ID.

Response Fields

FieldTypeDescription
idGuidVersion ID.
versionTagstringAuto-generated version label (e.g., `"Version 1"`).
createdDateDateTimeWhen this version was created (UTC).
statusstringVersion status. See **File Statuses** in the Get File docs.
commentsarrayComments on this version. See **Comment Fields**.
reviewsarrayReviews submitted on this version. See **Review Fields**.
formatsarrayUploaded formats for this version. See **Format Fields**.

Comment Fields

FieldTypeDescription
idGuidComment ID.
userIdGuidAuthor's user ID.
userNamestringAuthor's display name.
timeStampDateTimeWhen the comment was posted (UTC).
contentstringComment text.

Review Fields

FieldTypeDescription
idGuidReview ID.
reviewerIdGuidReviewer's user ID.
reviewerNamestringReviewer's display name.
responsestring`"Approved"`, `"Changes Requested"`, or `"No Response"`.

Format Fields

FieldTypeDescription
idGuidFormat ID.
typestringMIME type (e.g., `"application/pdf"`).
sizeintFile size in bytes.
uristringTime-limited SAS URI for downloading this format.

Error Codes

CodeHTTP StatusDescription
UNAUTHORIZED401Missing or invalid token, or insufficient permissions.
NOT_FOUND404File or version not found.