Retrieve an audience

GET/v1/audiences/{id}API key

Returns one audience. To see who is in it, use List audience contacts.

Path parameters

idstringpathrequired

The audience ID, for example aud_01K6C2A7F3H5J8K1M4N6P9Q2RS.

Response

The audience, with the fields described in Create an audience.

Errors

Status	Code	When
404	`audience_not_found`	No audience with that ID in this project.

Request

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

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

const audience = await flaresend.audiences.get('aud_01K6C2A7F3H5J8K1M4N6P9Q2RS');

Response

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

Path parametersCopy Anchor Link

ResponseCopy Anchor Link

ErrorsCopy Anchor Link

Path parameters

Response

Errors