Skip to main content
GET
/
files
/
asset-url
Get a signed URL for a file asset
curl --request GET \
  --url https://api.uk.veridox.ai/files/asset-url \
  --header 'x-api-key: <api-key>'
{
  "url": "<string>",
  "expires_at": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.veridox.ai/llms.txt

Use this file to discover all available pages before exploring further.

Generate a fresh signed URL for a specific asset attached to a case file. Use this endpoint when you need a short-lived URL for a single asset without fetching the full analysis response.

​
Supported Assets

Asset typeDescription
file_downloadThe original uploaded file
thumbnailA preview image of the file
pdf_reportThe PDF analysis report
log_outputRaw analysis log output
ela_overlayError Level Analysis overlay image

​
URL Expiration

Signed URLs expire 30 minutes after generation. Do not store them — call this endpoint again to get a fresh URL when needed.

​
Best Practices

  1. Request on demand: Fetch a signed URL immediately before you need to use it. Storing URLs risks serving expired links to your users.
  2. Check asset availability: A 404 with code request.cases.case-file.asset-not-found means the asset has not been generated yet or doesn’t exist for the file. Wait for the file’s analysis_status to reach settled before requesting report or overlay assets.
  3. Security: Never expose signed URLs in client-side code or public environments.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
file_id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
asset
enum<string>
required
Available options:
file_download,
thumbnail,
pdf_report,
log_output,
ela_overlay

Response

Signed URL generated

​
url
string<uri>
required
​
expires_at
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$