Get Audience | Pinnacle | Documentation

import { PinnacleClient } from "rcs-js";
async function main() {
    const client = new PinnacleClient({
        apiKey: "YOUR_API_KEY_HERE",
    });
    await client.audiences.get({
        id: "aud_abc123",
        page: 1,
        limit: 50,
    });
}
main();

{
  "id": "aud_abc123",
  "name": "VIP Customers",
  "description": "Our most valuable customers",
  "contacts": [
    {
      "description": "Premium customer",
      "email": "john@example.com",
      "id": "co_def456",
      "name": "John Doe",
      "phoneNumber": "+12125551234",
      "tags": [
        "vip",
        "enterprise"
      ]
    }
  ],
  "contactCount": 150,
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 150,
    "hasMore": true
  }
}

Retrieve an audience by ID with optional pagination.

Authentication

PINNACLE-API-KEYstring

API Key authentication via header

Query parameters

idstringRequiredformat: "^aud_"

Audience ID. This identifier is a string that always begins with the prefix aud_, for example: aud_abc123.

pageintegerOptional>=1Defaults to 1

Page number. If provided with or without limit, returns paginated contacts.

limitintegerOptional1-100Defaults to 50

Items per page. If provided with or without page, returns paginated contacts.

Response

Successfully retrieved audience.

Count Onlyobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error