API Reference

List audiences

GET /audiences — list every audience you own.

GET/audiences

List all audiences belonging to your account, newest first. Returns a list object whose data array holds the audiences. Each audience carries a domain field — the sending domain when the audience is a per-domain contact pool, or null for an audience you created yourself.

Request

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

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

Response (200)

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "audience",
      "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
      "name": "Registered Users",
      "domain": null,
      "created_at": "2026-06-23T17:22:43.000Z"
    }
  ]
}