List a contact's topic subscriptions
GET/api/v1/contacts/{id}/topics
GET /contacts/{id}/topics
curl -X GET 'https://www.unitpost.com/api/v1/contacts/con_123/topics' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'User-Agent: my-app/1.0'Response · 200
{
"object": "list",
"has_more": false,
"data": [
{
"object": "contact_topic",
"topic_id": "topic_123",
"subscribed": false,
"status": "subscribed",
"source": "user"
}
]
}Retrieve a contact's effective subscription state for every active topic, cursor-paginated. Each row resolves the contact's explicit preference against the topic's default_opt_in, so subscribed is always the answer to "would this contact receive a campaign scoped to this topic?". Change a preference with Set a contact's topic preference. Requires the topics:read capability.
Parameters4 fields
| Field | Type | Description |
|---|---|---|
idrequired | string · path | — |
limit | integer · query | Max rows to return (default 20, max 100). |
after | string · query | Return rows after this id (forward paging). |
before | string · query | Return rows before this id (backward paging). |
Response · 200 fields5 fields
| Field | Type | Description |
|---|---|---|
objectrequired | string | — |
topic_idrequired | string | — |
subscribedrequired | boolean | — |
statusrequired | enumsubscribed | unsubscribed | — |
sourcerequired | enumuser | manual | import | api | — |
200401404422