Get audience by ID | Smallest AI Docs

Retrieve a specific audience by its ID. Users can only access audiences they have created.

AuthorizationBearer

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

idstringRequired

The unique identifier of the audience

Successfully retrieved audience

statusboolean

dataobject

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

1	from smallest_ai 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	}