Return aggregate resolution-rate statistics for your organization,
rolled up across all of its pixels over the recent reporting window.
The headline number depends on which unit you look at. The event
rate counts pixel fires; the visitor (cookie) rate counts unique
people and is the honest per-visitor number, always lower because
resolved visitors generate many events while every bot or Safari hit
mints a throwaway cookie. The addressable rate is measured against
US traffic only, excluding bots and cookieless requests, and is the one
to benchmark against.
Non-US traffic sits outside that benchmark but is mostly still eligible
for resolution. A visitor on a non-US IP can and does resolve, usually at
a lower rate, whenever their identity is already known to the graph. Use
the ip_country field on the events endpoints to scope results by
visitor country.
The exception is the EEA, the UK and Switzerland. Visitors on an IP in
those 32 countries are never resolved, because their law requires opt-in
consent for the profile data we would attach. Their events are still
collected and returned; only the identity is withheld. See "Where we do
not resolve visitors" in the event field catalog for the country list.
The funnel partitions all events into priority-ordered, mutually
exclusive buckets, so the buckets sum to total_events. Priority, not
resolution alone, decides the bucket: Safari events that did resolve
are counted under resolved, not safari, and international holds
every non-US event, resolved or not, because resolved counts only
addressable (US) resolutions.
first_touch splits the rate by first-time vs returning visitors (the
most actionable view: returning visitors resolve far higher because
identity binds a cookie to a person over repeat visits).
Sections that need counters your data predates are omitted rather than
reported as zero.
By default the response aggregates every pixel in your organization over
the last seven completed days. The optional parameters below narrow it,
always within your own organization.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
400Invalid parameters (e.g. a malformed date, an incomplete date range, both project_id and pixel_id, or a partial/future end_date).
401Missing or invalid API credentials (X-Api-Key and/or X-Api-Secret).
404The requested project_id or pixel_id does not exist or does not belong to your organization.
503Resolution statistics are temporarily unavailable.
