API Reference

Retrieve segment

GET /segments/:id — fetch a single segment.

GET/segments/:id

Path parameters

segment_idstringrequired

The segment ID.

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

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

Response

{
  "object": "segment",
  "id": "seg_9a2f...",
  "audience_id": "aud_3b1c...",
  "name": "Gmail subscribers",
  "filter": { "status": "subscribed", "email_contains": "@gmail.com", "property_filters": [] },
  "created_at": "2026-06-23T10:00:00.000Z",
  "updated_at": "2026-06-23T10:00:00.000Z"
}