List Visitors
Get a paginated list of visitors for a site.
List Visitors
Returns a paginated list of visitors for a site, ordered by most recently seen.
Endpoint
GET /api/v1/organizations/:orgId/sites/:siteId/visitors
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page | number | No | Page number (default: 1) |
limit | number | No | Results per page (default: 50, max: 100) |
search | string | No | Search by email, name, UID, or external ID |
Response fields
Each visitor object in the visitors array:
| Field | Type | Description |
|---|---|---|
id | string | Visitor UUID |
uid | string | Persistent visitor UID from tracker |
email | string | Identified email (if set) |
name | string | Identified name (if set) |
avatar_url | string | Identified avatar URL (if set) |
external_id | string | Your user ID (if identified) |
first_seen_at | string | First visit timestamp |
last_seen_at | string | Most recent visit timestamp |
total_sessions | number | Lifetime session count |
total_pageviews | number | Lifetime pageview count |
total_goals | number | Lifetime goal completions |
total_revenue | number | Lifetime revenue |
last_country | string | Most recent country code |
last_browser | string | Most recent browser |
last_os | string | Most recent operating system |
last_device | string | Most recent device type |
last_referrer_source | string | Most recent traffic source |
The response also includes pagination metadata: total, page, and limit.
Visitor Timeline
To get the event timeline for a specific visitor:
GET /api/v1/organizations/:orgId/sites/:siteId/visitors/:visitorId/timeline
Returns the visitor profile along with a paginated list of their events.