segments
List the current members of a Segment
GET /v1/segments/{id}/members
Auth required
api.segments.view
Returns one page of a Segment's current members (contact id + email),
derived from the membership transition log. 404 not_found when the
Segment does not exist. Member emails are returned in full —
api.segments.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