Export Deals
Import & Export
Export Deals
Download deals as CSV for pipeline reporting and backups
GET
Export Deals
Request
Returns a CSV file of deals matching the query. Response is streamed withContent-Type: text/csv; charset=utf-8.
Query Parameters
Maximum rows to return. Maximum 50,000 per request.
Scope the export to a single pipeline.
Scope the export to a single pipeline stage.
Filter by status:
open, won, or lost.ISO 8601 lower bound on
created_at.ISO 8601 upper bound on
created_at.Comma-separated field whitelist. Defaults to
id,name,pipeline_id,stage_id,status,value,currency,company_name,owner_email,created_at,closed_at.Headers
Response
CSV stream withContent-Disposition: attachment; filename="deals-export.csv". First row is headers. Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-ID.
Example Response
Errors
| Status | Code | Description |
|---|---|---|
| 400 | validation_error | limit exceeds 50,000 or invalid filter value |
| 401 | invalid_key | Invalid or expired API key |
| 403 | insufficient_permissions | Missing read:deals permission |
| 429 | rate_limited | Export rate limit exceeded (10 per hour per workspace) |