Get audience sample

Retrieve a small preview of an audience so you can validate it before exporting. This is a capped, masked teaser, not a data feed: on an API key it returns up to 25 rows masked to company, department and seniority band, with firmographics, intent and has_* flags indicating which contact fields exist, plus masked: true and field_coverage. Names, titles, contact data and the hashed email are 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