Get audience by ID | Smallest AI Docs

Retrieve a specific audience by its ID. Note: if the audience belongs to a different organization, the API returns 404 (not 403) — ownership is deliberately obscured.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

idstringRequired

The unique identifier of the audience

Response

Successfully retrieved audience

statusboolean

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error

1	from smallestai import SmallestAI
2
3	client = SmallestAI(
4	token="YOUR_TOKEN_HERE",
5	)
6
7	client.atoms.audience.get_audience_by_id(
8	id="60d0fe4f5311236168a109ca",
9	)

1	{
2	"status": true,
3	"data": {
4	"_id": "60d0fe4f5311236168a109ca",
5	"name": "My Customer List",
6	"description": "List of customers for marketing campaign",
7	"phoneNumberColumnName": "phoneNumber",
8	"organization": "60d0fe4f5311236168a109cb",
9	"createdBy": "60d0fe4f5311236168a109cc",
10	"createdAt": "2025-01-15T10:30:00.000Z",
11	"updatedAt": "2025-01-15T10:30:00.000Z"
12	}
13	}