Skip to main content
POST
Identify company for a session

Authorizations

Authorization
string
header
required

Enter your personal access token (PAT) to authenticate

Path Parameters

trackingScriptId
string
required

Tracking script ID

Example:

"12345"

Body

application/json

Session context

session_uuid
string<uuid>

Lookup will be performed for this session UUID

Example:

"42b7c5e0-76c0-4f8d-9b7c-6b8e1a2d3f45"

since
string<date> | null

Optional anchor date (ISO 8601, UTC). When provided, the session lookup is scoped to events on that single calendar day instead of the default last-2-days window — use it to identify sessions older than 2 days. The date must not be in the future or more than 30 days ago. Omit it to use the default window.

Example:

"2026-05-11"

Response

Company identified

ip
string
required
Example:

"203.0.113.42"

domain
string
required
Example:

"acme.com"

type
enum<string>
required
Available options:
business,
educational,
government
Example:

"business"

company
object
required
geoIP
object
required
automation_detected
boolean

True when the session's own behaviour gave its browser away as automation (its heartbeats ran ahead of the clock). Such a session's network is not trusted for an identification, so expect a 404 for it in most cases.

Example:

false