v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB

Email Suppressions

Export suppressions as CSV

Streams the account's suppressions as a chunked CSV (server-side cursor; never materialized). Content-type text/csv, header Content-Disposition: attachment; filename="email_blocks_export.csv".

Filters (filter[reason], filter[domain_id], filter[created_after], filter[created_before]) are the only params that affect output. sort and page[*] are parsed (bad values still produce 400) but ignored — rows stream ORDER BY created_at ASC, id ASC with no pagination.

CSV columns: id,to,from,reason,source,scope,status,domain_id, created_at,updated_at,expires_at,group_id. The CSV carries the group_id column so group-scoped suppressions' group link survives the export (empty for account-scope rows).

get/email_blocks/export

Query parameters

sort'created_at' | '-created_at'

Sort field. Leading - = desc; only created_at is sortable. Default -created_at. -- is an error.

page[number]integer

Offset page number (≥1, default 1).

page[size]integer

Page size (1–100, default 25).

filter[reason]'hard_bounce' | 'spam_complaint' | 'unsubscribe' | 'invalid' | 'manual_block'

Exact-match filter on reason.

filter[domain_id]string uuid

Exact-match filter on domain_id (UUID).

filter[created_after]string date-time

created_at > value (ISO 8601).

filter[created_before]string date-time

created_at < value (ISO 8601).

Response

CSV stream.