GET/api/v1/usage/exports/{export_id}/download

Get 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_idstringrequired

    Export job id (uuid) from the create response.

Responses

  • 200

    A signed download link for the gzip JSONL file.

    Response
    • urlstringrequired

      Signed URL of the gzip JSONL file; needs no API key.

    • expires_atstringrequired
  • 401

    Missing, unknown or revoked API key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    No export with this id for your organization.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 409

    The export is not ready.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 410

    The export file has expired.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    The body or query failed validation.

    Response
    • detailarray<object>required
      detail
      • typestring
      • locarray<string | integer>
      • msgstring
  • 503

    The download link could not be minted.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-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