API Reference

List topics

GET /topics — list the topics on a sending domain.

GET/topics

Pass ?domain= to pick the sending domain whose topics to list — the parameter is required.

Query parameters

domainstringrequired

The sending domain whose topics to list.

limitnumberoptional

Number of topics to retrieve. Optional; if omitted, all topics are returned in a single response. Minimum 1, maximum 100.

afterstringoptional

The topic ID *after* which to retrieve more topics (for pagination). The ID is not included in the result. Cannot be combined with before.

beforestringoptional

The topic ID *before* which to retrieve more topics (for pagination). The ID is not included in the result. Cannot be combined with after.

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.topics.list({ domain: 'yourdomain.com' });
console.log({ data, error });

Response

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "topic_9a2f...",
      "name": "Product updates",
      "description": null,
      "default_subscription": "opt_in",
      "visibility": "private",
      "created_at": "2026-06-25T10:00:00.000Z"
    }
  ]
}