API documentation

GET /data_exports/:data_export_id/download

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/data_exports/:data_export_id/download

Download a data export file.

Redirects to a time-limited presigned S3 URL for the export file. Returns 404 if the file is not ready.

Example Request

curl 'https://[your-subdomain].trackdrive.com/api/v1/data_exports/10001' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "data_export": {
    "id": 10001,
    "type": "DataExport",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/data_exports/10001",
    "routes_edit_path": "/data_exports/10001/edit",
    "external_record_id": null,
    "company_id": 10002,
    "user_id": 10003,
    "data_type": "contact",
    "name": "Contact Suppression Export Records Source",
    "status": "complete",
    "created_at_from": "2026-01-15T12:30:00.000Z",
    "created_at_to": "2026-01-15T13:30:00.000Z",
    "started_at": "2026-01-15T13:30:00.000Z",
    "succeeded_at": "2026-01-15T14:30:00.000Z",
    "stopped_at": null,
    "total_count": 4,
    "export_count": 4,
    "export_file_url": null
  },
  "metadata": {
    "root": "data_export"
  }
}