Skip to content
Docs

Download Lead Export

Download the CSV of a completed lead export.

GET/api/v1/leads/export/{job_id}/download

Requires an API key with the read scope.

Returns the CSV file (text/csv). The export job must belong to your workspace and be completed; the file expires one hour after it was built.

Path Parameters#

job_idstringpathrequired
The lead_export job returned by Export Leads.

Response#

The response body is the CSV file, not JSON.

Errors#

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: read
404Job not found in this workspace, not finished, or the file expired

Rate Limit#

  • 300 requests per minute, shared by every read call in your workspace. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (read).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 4, 2026