Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Headers

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Example:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-08-05-1"

Body

application/json
account_id
string

Account to check. Defaults to the authenticated account.

url
string

A page to read for the pixel, e.g. an ad destination. Omit it to check the account from its events alone.

Response

pixel validated

firing_data_ok
boolean
required

False when the event lookup failed, meaning host_events and last_seen_days are incomplete.

host_events
string[]
required

Conversion event names detected on the requested page or fired recently anywhere on its hostname or final redirect hostname.

installed
boolean
required

True when the account has sent events recently, the pixel is present in the page at url, or url is hosted on Whop.

last_fired_days
object
required

Event name to whole days since that event last fired, e.g. { "lead": 3 }. Carries events that fired too long ago to count as installed, so you can prompt to re-check rather than report them missing.

last_seen_days
number | null
required

Days since the pixel last sent an event, within a 30-day window. null when it hasn't sent one in that window — which includes a pixel installed moments ago.

native_tracking
boolean
required

True when url is hosted on Whop, so no pixel snippet is required.

page_events
string[]
required

Conversion event names detected on the requested page, from its recent events or its source and linked scripts.

reachable
boolean | null
required

Whether the page could be loaded. null when the request included no URL, and true when events settled the answer without a fetch.

url
string | null
required

The URL that was checked, after normalization. null when the request didn't include one.