Audience and campaigns
Download a CSV export
Stream a ready, private export while rechecking workspace access and artifact validity.
GET
/api/v1/exports/{exportId}/downloadOn this page
Authentication
Send a RouteKite API key as a Bearer token. This endpoint requires the audience:read or campaign:read for the export dataset scope.
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Required for API clients | Bearer rk_ key with access to the exported dataset. |
Path parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
exportId | uuid | Required | Export identifier returned by export.create. |
Response
| Name | Type | Requirement | Description |
|---|---|---|---|
CSV | text/csv | Ready export | UTF-8, quoted fields, spreadsheet formula protection, and report timestamps. |
Authenticated download
Inspect export.get until the job is ready. Fetch its download_path with your Bearer API key, or open it in your authenticated dashboard session. No public signed link is issued. The CSV response is streamed in order and access is rechecked between parts.
Errors
| Status | Code | What it means | What to do |
|---|---|---|---|
| 403/404 | EXPORT_UNAVAILABLE | The export expired, was invalidated, or access was revoked. | Check workspace access or create a fresh export. |
| 503 | EXPORT_UNAVAILABLE | Storage or authorization could not be checked. | Retry while the artifact remains valid. |