List visitors
List visitors with summary stats, grouped by the resolved identity
(stitch - preferred - or session).
Each row is one visitor: page count, duration, device info, average
performance, the visit's pageviews as journey and its outcome. Cursor
paginated, ordered by (start_time DESC, id DESC). The full pageview record
of one visitor is /visitors/detail.
bearerAuthAuthorizationBearer <token>API token generated from the fastmon dashboard (Account → API Token) or at organization level (fmo_…, one that outlives its creator). Send as Authorization: Bearer fm_... or paste the full token (including its prefix) into the Authorize dialog.
org_id*Org Iduuidapplication/json- body
Request for the visitors list.
Cursor-paginated; always ordered by (start_time DESC, id DESC). Clients that want to re-sort do so over the loaded rows client-side.
time_range*Time range for the query
filters?Optional filters
identity?|Identifier to group visitors by: 'stitch' or 'session'. Null → the application's default (stitch preferred).
visitor_filters?Post-aggregation filters (page count, duration, errors, avg LCP)
search?|Search by visitor ID
limit?LimitMax visitors to return
1 <= value <= 10050cursor?|Opaque pagination cursor
Successful Response
application/json- response
data*array<>meta*Meta for ClickHouse-backed cursor-paginated lists.
total is intentionally absent: COUNT(*) over beacon tables is too
expensive. Clients rely on has_more + next_cursor instead.
curl -X POST 'https://api.fastmon.eu/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/analytics/visitors' \ -H 'Content-Type: application/json' \ -d '{ "time_range": { "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z" }}'{ "data": [ { "visitor_id": "string", "identity": "stitch", "started_at": "2019-08-24T14:15:22Z", "ended_at": "2019-08-24T14:15:22Z", "duration_ms": 0, "page_count": 0, "country": "string", "asn": 0, "isp": "string", "browser": "string", "browser_version": "string", "device_type": "string", "os": "string", "avg_lcp": 0, "avg_fcp": 0, "error_count": 0, "journey": [ { "page_type": "string", "checkout_stage": "cart", "duration_ms": 0, "error_count": 0 } ], "journey_truncated": false, "outcome": "ordered" } ], "meta": { "limit": 0, "has_more": true, "next_cursor": "string" }}