/api/v1/usage/exports/{export_id}/downloadGet a short-lived download link for an export
Re-authorizes, then returns a signed URL valid for at most 15 minutes (never past the file's own expiry). The URL itself needs no bearer key; do not log it. 409 means the job is not completed yet; 410 means the file expired and a new export is needed.
Authentication: Bearer API key in the Authorization header
Path parameters
export_idstringrequiredExport job id (uuid) from the create response.
Responses
200A signed download link for the gzip JSONL file.
Response
urlstringrequiredSigned URL of the gzip JSONL file; needs no API key.
expires_atstringrequired
401Missing, unknown or revoked API key.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
404No export with this id for your organization.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
409The export is not ready.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
410The export file has expired.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
422The body or query failed validation.
Response
detailarray<object>requireddetail
typestringlocarray<string | integer>msgstring
503The download link could not be minted.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
Request
curl https://api.experientiallabs.ai/api/v1/usage/exports/6e2b9c14-7d3a-4f01-8b5e-2c9a1d7f4e63/download \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"url": "https://storage.experientiallabs.ai/object/sign/usage-exports/6e2b9c14.jsonl.gz?token=eyJhbGciOi...",
"expires_at": "2026-11-19T16:20:12.000Z"
}https://api.experientiallabs.ai/api/v1/usage/exports/6e2b9c14-7d3a-4f01-8b5e-2c9a1d7f4e63/download