sendsend.email

List a contact’s topics

GET/v1/audiences/{id}/contacts/{contact}/topics

Every topic in the project and whether this contact is subscribed. A topic they have not chosen uses its default.

Required scope: contacts:manage

Parameters

NameInDescription
idrequiredpathThe audience id.
contactrequiredpathThe contact id or email address.

Example

curl -X GET 'https://api.sendsend.email/v1/audiences/ID/contacts/{contact}/topics' \
  -H "Authorization: Bearer $SENDSEND_API_KEY"

Response 200

{
  "object": "list",
  "data": [
    {
      "id": "top_Xa9…",
      "name": "Product news",
      "description": null,
      "subscription": "opt_in"
    }
  ]
}

Errors

StatusCodeWhen
404not_foundNo such resource in this project.
401unauthorizedThe API key is missing, invalid or revoked.
403forbiddenThe key does not have the scope this endpoint needs.

Every error has the same shape. See Errors.