List audiences

GET/v1/audiencesAPI key

Returns all of the project's audiences in one response, sorted by name. This list is not paginated.

Response

dataAudience[]

The audiences. Each has the fields described in Create an audience, including contactCount.

The Node.js client returns the array itself, not the { data } wrapper.

Request

import { Flaresend } from '@flaresend/client';

const flaresend = new Flaresend({
  apiKey: process.env.FLARESEND_API_KEY!,
  baseUrl: 'https://mailer.example.com',
});

const audiences = await flaresend.audiences.list(); // AudienceRecord[]

Response

{
  "data": [
    {
      "id": "aud_01K6C2A7F3H5J8K1M4N6P9Q2RS",
      "projectId": "proj_01K5Z8W2Q4R6T8V0X2Z4B6D8FG",
      "name": "Beta testers",
      "contactCount": 42,
      "createdAt": "2026-09-26T10:05:00.000Z"
    }
  ]
}

ResponseCopy Anchor Link

Response