lists

Check whether a contact is in a List

GET /v1/lists/{id}/members/{contactId}

Auth required api.lists.view

Returns the membership boolean for a contact in a List. A missing List is 404 not_found, but a non-member contact returns 200 with is_member: false (membership is a property of the List, not a sub-resource that can 404).

Path parameters

id string<uuid> required

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

contactId string<uuid> required

Contact UUID. Malformed values return 422 validation_failed.

Responses

200 Membership result 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