Get audience sample

Retrieve a small preview of an audience so you can validate it before exporting. This is a capped, redacted teaser, not a data feed: it returns up to 25 rows carrying firmographics, role, intent, first name, and the HEM match key, plus has_* flags indicating which contact fields exist. Raw contact data (emails, phones, LinkedIn, personal address, full name) is NOT returned here; download/unload the audience to get (and be billed for) the full contact records. total_count reports the audience's true size regardless of the sample size.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

Audience ID.

Query Params
uuid

Project ID (UUID). Every audience operation except GET /api/v1/audiences/schema is scoped to a project: send this parameter or the X-Project-Id header. Without either the request returns 400 with project_id is required.

integer
1 to 25

Number of sample rows to return. Capped server-side (max 25 on the API key path).

Headers
uuid

Project ID (UUID). Equivalent to the project_id query parameter; send one or the other.

Responses

401

Missing or invalid authentication.

403

Forbidden.

404

Audience not found.

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json