Topics
GET
Get Topic
GET /v1/topics/{topicId}Retrieve a specific topic by ID with full details.
Use Cases:
- Fetch topic details for display in preference centers
- Verify topic configuration before updates
- Check subscriber count for a topic
- Retrieve topic metadata for analytics
- Display topic information in your application
Behavior:
- Returns complete topic object with all metadata
- Includes current subscriber count (active subscriptions)
- Shows creation and last update timestamps
- Topic must belong to your workspace
- Works for both active and archived topics
Required Scope: read:topics
Response Includes:
- Topic identification (id, slug, name)
- Description and visibility settings
- Subscriber count (number of active subscriptions)
- Timestamps (createdAt, updatedAt)
- Workspace association
Path parameters
topicIdstringrequiredTopic ID
Response
200Successfully retrieved topic with full details, metadata, and subscriber count
objectstringrequiredidstringrequirednamestringrequireddescriptionanyrequiredvisibility"PUBLIC" | "PRIVATE"requireddefaultOptInbooleanrequired