API Reference

List domains

GET /domains — list every domain on your account.

GET/domains

Lists all domains on your account, newest first. Each entry is the same domain object returned by retrieve.

Query parameters

limitnumberoptional

Number of domains to retrieve. Optional — if omitted, all domains are returned in a single response. Maximum 100, minimum 1.

afterstringoptional

The ID *after* which to retrieve more domains (for pagination). This ID is not included in the returned list. Cannot be combined with before.

beforestringoptional

The ID *before* which to retrieve more domains (for pagination). This ID is not included in the returned list. Cannot be combined with after.

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.domains.list();
console.log({ data, error });

Response:

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "domain",
      "id": "d91a7c4e-1f2b-4a8c-9e3d-7b5f0a2c1d6e",
      "name": "yourdomain.com",
      "status": "verified",
      "region": "us-east-1",
      "created_at": "2026-06-23T12:00:00.000Z",
      "custom_return_path": "send",
      "open_tracking": false,
      "click_tracking": false,
      "tracking_subdomain": null,
      "tls": "opportunistic",
      "capabilities": {
        "sending": "enabled",
        "receiving": "disabled"
      },
      "tracking_domain": null,
      "tracking_verified": false,
      "records": [ ... ]
    }
  ]
}