List the members of a List

Search Documentation

Search across all developer documentation

lists

List the members of a List

GET /v1/lists/{id}/members
Auth required api.lists.view

Returns one page of a List's current members (contact id + email), newest-added first. 404 not_found when the List does not exist. Member emails are returned in full — api.lists.view is the PII gate.

Path parameters

id string<uuid> required

Resource UUID. An unparseable id reads as a clean 404 not_found.

Query parameters

limit integer optional

Page size (1–200). Default 50.

cursor string optional

Opaque cursor returned from the previous page.

Responses

200 Cursor-paginated list of members application/json
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
422 Query parameter or path value failed validation application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The code is internal_error. The request_id field can be quoted to SendOps support to investigate. application/problem+json