Docs

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

topicIdstringrequired

Topic ID

Response

200Successfully retrieved topic with full details, metadata, and subscriber count
objectstringrequired
idstringrequired
namestringrequired
descriptionanyrequired
visibility"PUBLIC" | "PRIVATE"required
defaultOptInbooleanrequired
Copyright © 2026 Kibamail.·Privacy Policy