Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like 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-07-27"

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 installed_events and last_seen_days are incomplete.

installed
boolean
required

True when the pixel was found — either the account has sent events recently, or the pixel is present in the page at url. False otherwise, including when the page couldn't be loaded.

installed_events
string[]
required

Conversion event names detected on the page or fired recently, e.g. lead, purchase. Excludes the events the pixel fires automatically on every page.

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 the URL is a Whop-hosted store page for this account, which Whop tracks natively — no pixel snippet is required there.

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.