Skip to main content
POST
Count and sample who a filter matches

Authorizations

Authorization
string
header
required

Tenant API key (vdx_live_…) as Authorization: Bearer.

Body

application/json
filter
object
required

A filter tree that compiles to a WHERE clause. Two things make customer-supplied JSON safe there: only whitelisted fields are reachable, and every value is bound — nothing a caller supplied is ever interpolated into statement text.

Attribute rules compile to an EXISTS, not a join: a join multiplies rows the moment two attribute rules appear in one filter, and an audience count has to be a count of people.

limit
integer
default:25
Required range: x <= 200
offset
integer
default:0

Response

The counts and a sample.

total
integer

People the filter matches.

suppressed
integer

Of those, how many would not be called.

accounts
object[]