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 max_active_recipients)
integer
required
Recipients you removed. An upsert or add reactivates them.
integer
required
Recipients who unsubscribed themselves. Never reactivated by the API.
integer
required
The plan’s active-recipient cap for this list: 500 on Free, 2,500 on Solo, 10,000 on Team. A write that would push active_count past it is rejected whole with 400 and code: recipient_cap_exceeded.
string
required
ISO 8601 creation timestamp
200

Errors

Rate Limits

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