This endpoint returns a short-lived signed download URL for a single file attached to an inspection.

Use it to download inspection photos, videos, audio files, PDF attachments, signatures, and instacount images programmatically. To find the IDs you need, first call Get a list of inspections with includes=files, then use each file's id as fileId.

The returned url is valid for a limited time only. After it expires, call this endpoint again to obtain a new download URL. Do not treat these URLs as permanent links.

Overview

The VLX API enables developers to download inspection file securely. The GET /v1/inspections/{inspectionId}/files/{fileId}/url endpoint returns a time-limited CloudFront signed URL that you can open in a browser or download with any HTTP client.

Supported file types

• image
• video
• audio
• attachment
• signature
• instacount

Endpoint Details

• Method: GET
• URL: https://api.visualogyx.com/v1/inspections/{inspectionId}/files/{fileId}/url
• Description: Returns a signed download URL for one inspection file artifact.

Request Information

Authentication

Include your private API key in the request header:

• Header: access-token
• Required: Yes

Path Parameters

Required Permission

Your API key must have Inspections → Read access (inspections:read).

Potential Errors

• 400 Bad Request: Triggered by invalid or missing inspectionId or fileId, a malformed UUID, or an unsupported file type (only image, video, audio, attachment, signature, and instacount are supported).
• 401 Unauthorized: Occurs if the API key is missing or invalid, or you attempt to access an inspection that your organization does not have permission to view.
• 403 Forbidden: Occurs if your API key does not have permission for this endpoint (inspections.file.url / Inspections read access).
• 404 Not Found: Returned if the inspection or file cannot be found, or the file does not belong to the specified inspection.