List the people in a signals state

Pages the people in one signals state of an intents or persona audience, ordered by hashed email, with CCPA opt-outs removed. Use it to get the people behind the counts on the overview.

Only intents and persona audiences have member lists. Any other audience returns 400.

Billing. An API-key caller is billed one predictive_signal unit per member returned. A retried page is billed once. The dashboard view is not billed: pages are capped at 50 and each hashed email is masked to its first 8 characters.

Paging. day defaults to the latest signals day. Pass next_cursor back as cursor to fetch the next page; the cursor keeps its day and resumes after the last member returned. next_cursor is absent on the last page. When the audience has no signals day yet, the page is empty.

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

Audience ID.

Query Params
uuid
required

Project ID (UUID). The X-Project-Id header is equivalent.

string
enum
required

The signals state to list.

Allowed:
string

Signals day, YYYYMMDD. Defaults to the latest day.

integer
1 to 5000
Defaults to 1000

Members per page, 1 to 5000. A value outside the range returns 400.

string

The next_cursor from the previous page.

Responses

400

Invalid request. A missing project, an unknown state, a bad day, page_size or cursor, an unknown query parameter, or an audience without member lists.

401

Missing or invalid authentication.

404

Audience not found in this project.

503

Member lists are temporarily unavailable. Retry shortly. Nothing is billed.

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