VeristageDevelopers
Files

Download an alternative file

GET/resources/{ref}/files/{id}

Streams a specific alternative file as raw bytes with the correct Content-Type and a Content-Disposition: attachment filename (the file's display name, falling back to its stored filename). Supports HTTP Range requests. Requires the read scope.

Authorization

apiKey
X-Api-Key<token>

Issued to you when your integration is provisioned. Determines which catalogue resources are visible and which AI tools are available.

In: header

Path Parameters

ref*integer

Resource ref.

id*integer

Alternative file id from GET /resources/{ref}/files.

Response Body

application/octet-stream

application/octet-stream

application/json

application/json

application/json

curl -X GET "https://example.com/resources/0/files/0"
"string"
"string"

{  "success": false,  "status": "fail",  "message": "API key is required",  "error": {    "code": "NO_API_KEY",    "message": "API key is required"  }}

{  "success": false,  "status": "fail",  "message": "string",  "error": {    "message": "API key is required",    "code": "NO_API_KEY"  }}
{  "success": false,  "status": "fail",  "message": "string",  "error": {    "message": "API key is required",    "code": "NO_API_KEY"  }}

Download the resource's original file GET

Streams the resource's original file as raw bytes with the correct `Content-Type` and a `Content-Disposition: attachment` filename taken from the resource's stored filename. Requires the **read** scope. Supports HTTP `Range` requests for resumable downloads (responds `206 Partial Content`). Access follows the internal download rules: confidential resources are denied, and restricted-access users cannot download originals (`403 DOWNLOAD_NOT_ALLOWED`).

List downloadable files for a resource GET

Returns the original file (when present and downloadable at the linked user's access level — `null` otherwise) and all alternative files attached to the resource (e.g. `formatted_extract` entries produced by the formatted-document-extract feature, audio samples, supplementary files). Each entry carries a `downloadUrl` you can fetch directly with the same api-key. Requires the **read** scope.