Identities

User referrers

GET
/identities/referrers

One user's top referrers over a window. Organization-wide; requires owner/admin. Identify by email, user_id, or identity_id (exactly one). Returns identity_id and referrers, each with referrer and count.

Authorization

AuthorizationBearer <token>

Organization API Token (prefixed sk_) sent as Authorization: Bearer sk_.... Create one in Settings and grant it scopes. Server-side only.

In: header

Query Parameters

email?string

The user's email address. Provide exactly one of email, user_id, or identity_id.

Length1 <= length
user_id?string

The user_id as sent to Leapio via identify/track. Provide exactly one of email, user_id, or identity_id.

Length1 <= length
identity_id?string

An identity id from another tool, such as the resolved_identifier that company_top_users or group_top_users returns. Provide exactly one of email, user_id, or identity_id.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
start_date?string

Inclusive start of the window (ISO-8601). Defaults to 30 days ago.

end_date?string

Inclusive end of the window (ISO-8601). Defaults to now.

limit?integer

Maximum referrers to return (1-50). Defaults to 10.

Range1 <= value <= 50

Response Body

curl -X GET "https://example.com/identities/referrers"
Empty