lists
List static Lists
GET /v1/lists
Auth required
api.lists.view
Returns the org's static Lists, newest-first. A List is an explicit,
operator-managed membership set — a contact stays a member until it is
removed or deleted. Segments (/v1/segments) are the dynamic,
predicate-driven counterpart. Definition writes (create/edit/delete)
are available under api.lists.manage; membership add/remove lives on
the contacts surface (lists on /v1/contacts). Cursors are opaque
base64; stale or malformed cursors silently fall back to page 1.
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 Lists, newest-first 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
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