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.
Authentifizierung
bearerAuth 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.
In: header
Pfad-Parameter
uuidRequest-Body
application/json
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.
Response-Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/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", "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" }}