Skip to content
Docs

Export Block ListBeta

Download the block list as CSV.

GET/api/v1/block-list/export

Requires an API key with the read scope.

Returns text/csv with the columns value, kind, source, note, createdAt, newest first, up to 100,000 rows.

Query Parameters#

searchstringquery
Substring of the email or domain.
kindstringquery
email or domain.

Errors#

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: read

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, see Rate Limiting.

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