DocumentationAPI Reference
DocumentationAPI ReferenceOpenAPIStatus

Downloading Files

Files belonging to your organization can be downloaded from

These files can include photos associated with a verification, such as driver license or passport photos, or key photos extracted from the selfie video.

Any files connected to an Inquiry will be available to download via the "Retrieve an Inquiry" API endpoint. File URLs will be available within the included document or selfie objects within the API response.

In API responses, file URLs appear in the form[filename].[extension]?access_token=[token]. Each file URL contains a signed access token, and thus can load the file without an additional Persona API key in the request header.

By default, each URL remains valid for 6 hours after the API request was made. Afterwards, the access token expires, and a new API request must be made to obtain new file URLs. The expiration timeout is configurable per API key, up to 1 day.