topics
List subscription topics
GET /v1/topics
Auth required
api.topics.view
Returns every subscription topic on the org's contact list. Topics
are list-level metadata with no recipient PII, so this endpoint sits
behind the narrower api.topics.view scope. SES caps a contact list
at 50 topics, so the response is not paginated. subscriber_count is
the number of contacts with an explicit OPT_IN preference for the
topic. When no contact list is synced, an empty array is returned.
Responses
200 All topics on the contact list (unpaginated) 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
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