Download export

GET

exports

{export_id}

download

import olira

olira.init(api_key="YOUR_API_KEY")
dl = olira.download_export(export_id="exp-job-001")
print(dl.download_url, dl.expires_in_seconds)

using Olira;

OliraModule.Init(apiKey: "YOUR_API_KEY");
var dl = OliraModule.DownloadExport(exportId: "exp-job-001");
Console.WriteLine(dl.DownloadUrl);

GET /v1/exports/exp-job-001/download
Authorization: Bearer YOUR_API_KEY

ExportDownload(
    export_id="exp-job-001",
    download_url="https://…/export.zip?…",
    expires_in_seconds=3600,
    byte_size=11817,
)

{
  "error": true,
  "status_code": 401,
  "error_type": "authentication_error",
  "message": "Could not validate credentials",
  "details": [
    {
      "type": "authentication_error",
      "message": "Could not validate credentials"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 403,
  "error_type": "authorization_error",
  "message": "Insufficient OAuth scope for this endpoint",
  "details": [
    {
      "type": "authorization_error",
      "message": "Insufficient OAuth scope for this endpoint"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 404,
  "error_type": "not_found_error",
  "message": "Patient not found",
  "details": [
    {
      "type": "not_found_error",
      "message": "Patient not found"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 422,
  "error_type": "validation_error",
  "message": "Request validation failed (1 error)",
  "details": [
    {
      "type": "missing",
      "message": "Field required",
      "field": "patient_id",
      "location": ["body", "patient_id"],
      "input_value": null
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 429,
  "error_type": "server_error",
  "message": "Rate limit exceeded",
  "details": [
    {
      "type": "rate_limit",
      "message": "Too many requests; retry after backoff"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 500,
  "error_type": "internal_server_error",
  "message": "An internal server error occurred",
  "details": [
    {
      "type": "internal_server_error",
      "message": "An unexpected error occurred while processing your request"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

olira.download_export(export_id: str) -> ExportDownload

OliraModule.DownloadExport(string exportId)  // -> ExportDownload

Requires scope: sdk:state-read Call only when get_export reports downloadable=True.

Parameters

str

required

Export job id.

Returns

ExportDownload

str

Export job identifier.

str

Presigned GET URL for the zip.

int

URL TTL (typically 3600).

int | None

Zip size in bytes.

str | None

SHA-256 of the zip.

str | None

Object key in the exports bucket.

Raises

Exception	When
`ValidationError`	Export is not ready for download (HTTP 409) or unknown id (HTTP 404).
`AuthError`	HTTP 401 or 403 — invalid API key or insufficient OAuth scope for this endpoint.
`ServerError`	HTTP 409 (e.g. conflicting external identifier) or repeated 5xx after retries; includes status_code when applicable.
`RateLimitError`	HTTP 429 — rate limited; check retry_after (seconds).
`NetworkError`	Connection timeout, DNS failure, or read error after retries.

import olira

olira.init(api_key="YOUR_API_KEY")
dl = olira.download_export(export_id="exp-job-001")
print(dl.download_url, dl.expires_in_seconds)

using Olira;

OliraModule.Init(apiKey: "YOUR_API_KEY");
var dl = OliraModule.DownloadExport(exportId: "exp-job-001");
Console.WriteLine(dl.DownloadUrl);

GET /v1/exports/exp-job-001/download
Authorization: Bearer YOUR_API_KEY

ExportDownload(
    export_id="exp-job-001",
    download_url="https://…/export.zip?…",
    expires_in_seconds=3600,
    byte_size=11817,
)

{
  "error": true,
  "status_code": 401,
  "error_type": "authentication_error",
  "message": "Could not validate credentials",
  "details": [
    {
      "type": "authentication_error",
      "message": "Could not validate credentials"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 403,
  "error_type": "authorization_error",
  "message": "Insufficient OAuth scope for this endpoint",
  "details": [
    {
      "type": "authorization_error",
      "message": "Insufficient OAuth scope for this endpoint"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 404,
  "error_type": "not_found_error",
  "message": "Patient not found",
  "details": [
    {
      "type": "not_found_error",
      "message": "Patient not found"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 422,
  "error_type": "validation_error",
  "message": "Request validation failed (1 error)",
  "details": [
    {
      "type": "missing",
      "message": "Field required",
      "field": "patient_id",
      "location": ["body", "patient_id"],
      "input_value": null
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 429,
  "error_type": "server_error",
  "message": "Rate limit exceeded",
  "details": [
    {
      "type": "rate_limit",
      "message": "Too many requests; retry after backoff"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 500,
  "error_type": "internal_server_error",
  "message": "An internal server error occurred",
  "details": [
    {
      "type": "internal_server_error",
      "message": "An unexpected error occurred while processing your request"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

import olira

olira.init(api_key="YOUR_API_KEY")
dl = olira.download_export(export_id="exp-job-001")
print(dl.download_url, dl.expires_in_seconds)

using Olira;

OliraModule.Init(apiKey: "YOUR_API_KEY");
var dl = OliraModule.DownloadExport(exportId: "exp-job-001");
Console.WriteLine(dl.DownloadUrl);

GET /v1/exports/exp-job-001/download
Authorization: Bearer YOUR_API_KEY

ExportDownload(
    export_id="exp-job-001",
    download_url="https://…/export.zip?…",
    expires_in_seconds=3600,
    byte_size=11817,
)

{
  "error": true,
  "status_code": 401,
  "error_type": "authentication_error",
  "message": "Could not validate credentials",
  "details": [
    {
      "type": "authentication_error",
      "message": "Could not validate credentials"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 403,
  "error_type": "authorization_error",
  "message": "Insufficient OAuth scope for this endpoint",
  "details": [
    {
      "type": "authorization_error",
      "message": "Insufficient OAuth scope for this endpoint"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 404,
  "error_type": "not_found_error",
  "message": "Patient not found",
  "details": [
    {
      "type": "not_found_error",
      "message": "Patient not found"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 422,
  "error_type": "validation_error",
  "message": "Request validation failed (1 error)",
  "details": [
    {
      "type": "missing",
      "message": "Field required",
      "field": "patient_id",
      "location": ["body", "patient_id"],
      "input_value": null
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 429,
  "error_type": "server_error",
  "message": "Rate limit exceeded",
  "details": [
    {
      "type": "rate_limit",
      "message": "Too many requests; retry after backoff"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 500,
  "error_type": "internal_server_error",
  "message": "An internal server error occurred",
  "details": [
    {
      "type": "internal_server_error",
      "message": "An unexpected error occurred while processing your request"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

Log types

SDK

Download export

Parameters

Returns

Raises

​Parameters

​Returns

​Raises

Parameters

Returns

Raises