Get Topic Contacts

Retrieve all contacts subscribed to a specific topic.

Use Cases:

• Export subscribers for a specific newsletter topic
• Send targeted communications to topic subscribers
• Analyze subscriber demographics by topic
• Build topic-specific reports
• Verify subscription lists before campaigns

Behavior:

• Returns only actively subscribed contacts (not unsubscribed)
• Uses cursor-based pagination for efficiency
• Includes complete contact data and properties
• Maximum 100 contacts per request
• Sorted by subscription date (newest first)
• Contact must have active subscription to this topic

Required Scope: read:contacts and read:topics

Response Includes:

• Complete contact objects with all properties
• Contact's subscription status for this topic
• All other topic subscriptions for each contact
• Contact metadata (createdAt, updatedAt)
• Pagination cursors

Subscription Status:

• Only includes contacts with active subscriptions
• Unsubscribed contacts are excluded
• Globally unsubscribed contacts are excluded
• Pending/double-opt-in contacts may be included (check status)

Note: This returns the current snapshot. Subscriptions may change between paginated requests.