Skip to main content
GET
Get Mailing List
Returns a single mailing list with its recipient counts — the quickest way to check that a sync landed (active_count went up) without paging through recipients.

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).

Request

cURL

Response

string
required
The mailing list’s unique identifier (UUID)
string
required
The mailing list’s name
integer
required
Total recipients on the list, in every status
integer
required
Recipients who will receive the next release email (at most 500)
integer
required
Recipients you removed. An upsert or add reactivates them.
integer
required
Recipients who unsubscribed themselves. Never reactivated by the API.
string
required
ISO 8601 creation timestamp
200

Errors

Rate Limits

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