API Reference

Retrieve audience

GET /audiences/:id — fetch a single audience by id.

GET/audiences/:id

Retrieve a single audience you own by its id.

Request

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

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

Response (200)

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

An unknown id (or one you do not own) returns 404 not_found. See Errors.