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. Minimum 1, maximum 100. Optional — when omitted, this endpoint returns up to 1000 domains in a single response and sets has_more: true if it had to truncate.

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",
      "zone": "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,
      "aws_last_checked_at": null,
      "aws_check_error": null,
      "records": [ ... ]
    }
  ]
}