seen_countcounts distinct observed sessions. Session detail reportsvisitor_fingerprint.lifecycle.resolution_countinstead, which counts page loads across the whole organization, so the two numbers differ.- First/last seen and latest request describe those observations.
- Visitors without observations in your environment return 404 and do not appear in lists.
null anchors, an empty component vector, and false storage flags because the identity store cannot attribute these fields to an environment. Treat the storage flags as unavailable, not as evidence that browser storage was absent. These fields are deprecated and will be removed. You can still view organization-wide identity details in the dashboard.
In activity.sessions[].decision, phase, is_provisional, and evaluation_duration_ms are null when the decision did not record them.
Endpoint summary
GET /v1/fingerprints
Requires a secret key with the fingerprints:list scope.
Supported query parameters:
Without
sort, the list starts with the visitors seen most recently. A limit, sort, or cursor value that isn’t valid returns 422 with request.validation_failed. A cursor works only with the sort value of the request that returned it. See Pagination.
Example response:
lifecycle.expires_at is always 9999-12-31T00:00:00.000Z. This value is a sentinel that means the fingerprint doesn’t expire, so don’t treat it as a date to schedule against. The field is deprecated and will be removed.
GET /v1/fingerprints/:visitorId
Returns the visitor fingerprint detail plus a recent linked-session summary. Requires a secret key with the fingerprints:read scope. activity.sessions lists up to 100 recent decisions for sessions linked to this visitor, newest first.
Example response: