API Reference

List audiences

GET /audiences — page through the audiences you own.

GET/audiences

List the 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.

This list is paginated — at most 20 audiences come back unless you raise limit, and has_more tells you whether to keep walking with after. An account with 50 audiences receives 20 with has_more: true.

Query parameters

limitintegeroptional

How many audiences to return. An integer between 1 and 100, defaulting to 20 — this endpoint always applies the limit.

afterstringoptional

Cursor: return the audiences that follow this audience id. The id itself is not included. See Pagination.

beforestringoptional

Cursor: return the audiences that precede this audience id. Cannot be combined with after.

Request

import { Mailblastr } from 'mailblastr';

const mb = new Mailblastr('mb_xxxxxxxxx');

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

import { Mailblastr } from 'mailblastr';

const mb = new Mailblastr('mb_xxxxxxxxx');

const { data, error } = await mb.audiences.list({ limit: 100, after: '78261eea-8f8b-4381-83c6-79fa7120f1cf' });
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"
    }
  ]
}

A limit outside 1-100 (or a non-integer), or after and before together, returns 422 validation_error. An unknown cursor returns an empty page rather than an error. See Pagination and Errors.