Skip to main content
GET
Export Recipients
Returns the list’s recipients as a CSV attachment — every status unless you filter — with the columns:
attributes is compact JSON (empty when the recipient has none). The same file is what the dashboard’s Export CSV button downloads, and its columns are accepted back by the dashboard’s Import CSV.

Authentication

This endpoint requires an API token passed as a Bearer token in the Authorization header.

Path Parameters

string
required
The mailing list’s unique identifier (UUID).

Query Parameters

string
Only recipients in this status: active, removed or unsubscribed.

Request

cURL

Response

200 OK with Content-Type: text/csv; charset=utf-8 and a Content-Disposition: attachment; filename="<list-name>-recipients.csv" header.

Errors

Rate Limits

This endpoint is limited to 20 requests per minute per IP.