Skip to main content

Sessions

The Sessions page lets you search and inspect individual fingerprint sessions.

Searching sessions

Dashboard and Pub API support these search types:
Search typeField
user_hidHashed user identifier
visitor_idDerived visitor UUID
device_idDerived device UUID
cookie_idPersistent visitor cookie ID
session_idBrowser session (~10 min)
ipClient IP address
request_idSingle check UUID
webrtc_ip is used in behavioral patterns, not in session search endpoints.

Session details

FieldDescription
RequestIDUnique check ID
SessionIDBrowser session ID
CookieIDVisitor cookie ID
DeviceIDDevice fingerprint UUID
VisitorIDDevice + cookie derived UUID
UserHIDHashed user identifier
IPClient IP
OSUser-Agent OS
CountryIP geolocation
BrowserDetected browser
ScoreTrust Score (0–999)
DetailsFired signals
WebRtcHIPWebRTC-detected IP
TcpMssTCP MSS (Shield.Tcp)
MtuHintdirect, vpn, tor_double_vpn, datacenter
CreatedAtTimestamp

Pub API

Base URL: https://account.shieldlabs.ai
GET /pub/{public_key}/{secret_key}/debug/user_hid/{hash}?limit=20
GET /pub/{public_key}/{secret_key}/history/device_id/{uuid}?limit=50&offset=0
GET /pub/{public_key}/{secret_key}/request/{request_id}
See Identify and History.

Export

JWT API on account.shieldlabs.ai:
GET /api/request/{site_id}/export/csv
GET /api/request/{site_id}/export/json