List Audiences | Pinnacle

List all audiences with optional filtering and pagination. Results are sorted by creation date, newest first.

PINNACLE-API-KEYstring

API Key authentication via header

This endpoint expects an object.

pageIndexintegerOptional>=0Defaults to 0

pageSizeintegerOptional1-100Defaults to 20

namestringOptional

Filter audiences by name (partial match).

Returns paginated list of audiences.

datalist of objects

hasMoreboolean

countinteger

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

1	curl -X POST https://api.pinnacle.sh/audiences/list \
2	-H "PINNACLE-API-KEY: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{}'

1	{
2	"data": [
3	{
4	"id": "aud_abc123",
5	"name": "VIP Customers",
6	"description": "Our most valuable customers",
7	"createdAt": "2025-01-15T10:30:00Z",
8	"updatedAt": "2025-02-20T14:00:00Z"
9	},
10	{
11	"id": "aud_def456",
12	"name": "Beta Testers",
13	"description": "Users in the beta program",
14	"createdAt": "2025-01-10T08:00:00Z",
15	"updatedAt": "2025-01-10T08:00:00Z"
16	}
17	],
18	"hasMore": true,
19	"count": 12
20	}