Skip to main content
How delivery works
Language

S3 export

Deliver every completed Device Intelligence evaluation to your own S3 bucket as JSONL, including the full device fingerprint, network, IP, geo, VPN, and bot signals.

The Device Intelligence S3 export writes every completed evaluation to an S3 bucket you own, so you can load fingerprint and risk data into your own warehouse, fraud tooling, or analytics pipeline. Each record contains the full device fingerprint plus the network, IP, geo, VPN, and bot signals cside computed for that visit.

Paid Device Intelligence feature

The S3 export is available on paid Device Intelligence plans. Enable and configure it under Settings > Device Intelligence in the dashboard. On a plan change, the export pauses or resumes on its own, with no reconfiguration.

How delivery works

  • Format: JSONL (JSON Lines). Each line is one complete evaluation record, encoded as application/x-ndjson.
  • Cadence: cside uploads one batch per hour.
  • Object name: fingerprints-team-<team_id>-<from>-<to>.jsonl, where <from> and <to> are the hour boundaries of the batch.
  • Destination: your bucket. cside writes objects but never reads or lists them.
Recommended lifecycle rule

Uploads use S3 multipart. An interrupted upload leaves its parts in your bucket. Add an AbortIncompleteMultipartUpload lifecycle rule so they do not accumulate.

Record structure

Every line is a JSON object with a set of top-level identity fields plus nested objects for each signal group:

ObjectDescription
fingerprintThe device fingerprint (browser, hardware, rendering, and environment signals).
network_client_metricsTCP and TLS characteristics of the connection.
ip_enrichmentASN, geo, and privacy data derived from the visitor IP.
geo_lite_city_dataCity-level geolocation for the visitor IP.
vpn_evaluationVPN likelihood and supporting signals.
bot_evaluationBot likelihood, verdict, and supporting signals.
fingerprint_enrichmentSignals derived from the fingerprint, such as disposable email detection.
rule_evaluationsNamed rule outcomes evaluated for this visit.
Absent keys mean default values

A field appears only when it has a non-default value. A missing key means the value was empty, false, 0, or not collected. When you parse the file, treat an absent key as a default, not an error.

Top-level fields

FieldTypeDescription
evaluation_idstringUnique ID for this evaluation. Also present as id.
customer_idstringYour domain’s cside ID. Also present as domain_id.
customer_domainstringThe domain being evaluated.
team_idstringYour cside team ID.
timestampstringEvaluation time, ISO 8601. Also present as created_at.
page_urlstringThe page where the evaluation was triggered.
session_idstringBrowser session ID.
request_idstringUpstream request correlation ID.
client_ipstringVisitor IP address.
user_agentstringVisitor browser user agent.
evaluation_statusstringEvaluation status. Completed records only.
error_messagestringError details for a failed evaluation. Empty for completed records, so normally absent.
device_fingerprintstringCompact device fingerprint token (base64).
threat_fingerprintstringCompact threat fingerprint token (base64).

fingerprint object

The device fingerprint is the largest object. The tables below group its fields by category.

Identity

FieldTypeDescription
device_idstringStable device identifier derived from the collected signals.

Browser and system

FieldTypeDescription
productstringBrowser navigator.product value.
product_substringBrowser navigator.productSub value.
browser_namestringBrowser name.
browser_versionstringBrowser version.
mobilebooleanWhether the browser reports as mobile.
apple_pay_versionnumberApple Pay API version, when available.
user_agentstringBrowser user agent string.
pluginsstring[]Installed browser plugins.
platformstringOperating system platform.
cpu_architecturestringReported CPU architecture.
hardware_architecturenumberHardware architecture indicator.
connectionstringNetwork connection type (for example 4g).

Rendering (Canvas, WebGL, WebGPU)

FieldTypeDescription
canvas_signalstringCanvas rendering signal.
webgl_signalstringWebGL rendering signal.
webgl_vendorstringWebGL vendor string.
webgl_rendererstringWebGL renderer string.
video_card_vendorstringGPU vendor.
video_card_rendererstringGPU renderer.
video_card_vendor_unmaskedstringUnmasked GPU vendor, when available.
video_card_renderer_unmaskedstringUnmasked GPU renderer, when available.
video_card_versionstringGPU driver version string.
video_card_shading_language_versionstringShading language version.
webgpu_supportedbooleanWhether WebGPU is supported.
webgpu_adapterstringWebGPU adapter description.
webgpu_signalstringWebGPU rendering signal.

Locale and time

FieldTypeDescription
timezonestringReported time zone.
localestringReported locale.
languagesstring[]Accepted languages.

Audio

FieldTypeDescription
audio_signalstringAudio fingerprint signal.
audio_max_channelsnumberMaximum audio output channels.
audio_channel_count_modestringAudio channel count mode.

Hardware

FieldTypeDescription
device_memorynumberReported device memory in GB.
hardware_concurrencynumberNumber of logical CPU cores.
js_heap_size_limitnumberJavaScript heap size limit in bytes.
math_valuesobjectResults of math precision probes, keyed by operation.

Screen

FieldTypeDescription
screen_widthnumberScreen width in pixels.
screen_heightnumberScreen height in pixels.
screen_resolutionstringScreen resolution string.
color_depthnumberScreen color depth.
device_pixel_rationumberDevice pixel ratio.
touch_supportbooleanWhether touch input is supported.
max_touch_pointsnumberMaximum simultaneous touch points.
media_matchesstring[]Matched CSS media queries.

Browser APIs

FieldTypeDescription
online_statusbooleanWhether the browser reports as online.
do_not_trackstringDo Not Track setting.
cookies_enabledbooleanWhether cookies are enabled.
media_devicesstring[]Available media device kinds.
indexeddb_supportbooleanIndexedDB support.
localstorage_supportbooleanlocalStorage support.
sessionstorage_supportbooleansessionStorage support.
bluetooth_supportbooleanWeb Bluetooth support.
geolocation_supportbooleanGeolocation API support.
device_motion_supportbooleanDevice motion support.
device_orientation_supportbooleanDevice orientation support.
speech_recognition_supportbooleanSpeech recognition support.
vibration_supportbooleanVibration API support.
gamepad_supportbooleanGamepad API support.
fullscreen_supportbooleanFullscreen API support.
clipboard_supportbooleanClipboard API support.
service_worker_supportbooleanService Worker support.
webassembly_supportbooleanWebAssembly support.

Preferences

FieldTypeDescription
prefers_dark_modebooleanPrefers dark color scheme.
prefers_reduced_motionbooleanPrefers reduced motion.

Fonts

FieldTypeDescription
detected_fontsstring[]Fonts detected on the device.
font_metricsobjectFont rendering metrics, keyed by measurement.

Network signals

FieldTypeDescription
stun_ipsstring[]Local IP addresses discovered via STUN.
permission_statesobjectPermission states, keyed by permission name.

WebRTC, speech, and MathML

FieldTypeDescription
webrtc_supportedbooleanWebRTC support.
webrtc_hashstringHash of the WebRTC feature set.
webrtc_detailsobjectDetailed WebRTC capabilities.
webrtc_errorstringWebRTC probe error, when one occurred.
speech_synthesis_supportedbooleanSpeech synthesis support.
speech_hashstringHash of the speech synthesis voice set.
speech_detailsobjectDetailed speech synthesis data.
speech_errorstringSpeech probe error, when one occurred.
mathml_supportedbooleanMathML support.
mathml_hashstringHash of MathML rendering.
mathml_detailsobjectDetailed MathML rendering data.
mathml_errorstringMathML probe error, when one occurred.

Performance and battery

FieldTypeDescription
fpsnumberMeasured frames per second.
battery_infoobjectBattery state: charging, level, charging_time, discharging_time.

Incognito detection

FieldTypeDescription
incognito_detectedbooleanWhether a private browsing mode was detected.
incognito_supportstringDetection method support level.
incognito_methodstringDetection method used.
incognito_quota_bytesnumberStorage quota observed during detection.

Developer tools detection

FieldTypeDescription
developer_tools_detectedbooleanWhether developer tools appear to be open.
developer_tools_supportstringDetection support level.
developer_tools_methodstringDetection method used.
developer_tools_gap_pxnumberWindow gap in pixels used for detection.

Virtual machine detection

FieldTypeDescription
virtual_machine_detectedbooleanWhether the device appears to be a virtual machine.
virtual_machine_supportstringDetection support level.
virtual_machine_reasonstringReason the device was flagged.

Automation and tampering

FieldTypeDescription
web_driverbooleanWhether navigator.webdriver is set.
web_driver_tamperedbooleanWhether the webdriver flag appears tampered.
cdpbooleanChrome DevTools Protocol usage detected.
cdp_tamperedbooleanWhether CDP signals appear tampered.
tamper_injected_globalsstring[]Suspicious injected global variables.
tamper_expose_binding_leakbooleanBinding leak associated with automation.
tamper_desc_instance_ownstring[]Anomalous own property descriptors.
tamper_desc_proto_nonnativestring[]Non-native prototype descriptors.
tamper_xrealm_webdriver_mismatchbooleanCross-realm webdriver mismatch.
tamper_xrealm_renderer_deltabooleanCross-realm renderer difference.
tamper_probe_blockedbooleanWhether tamper probes were blocked.

Device attestation

FieldTypeDescription
device_uvpaabooleanUser-verifying platform authenticator available.
device_client_caps_countnumberCount of reported client capabilities.
device_caps_uvpabooleanPlatform authenticator capability.
device_apple_pay_active_cardbooleanApple Pay has an active card.
device_payment_enrolledbooleanDevice is enrolled in a payment method.
device_serial_presentbooleanSerial capability present.
device_hid_presentbooleanHID capability present.
device_notif_staticstringStatic notification capability signal.
device_notif_queriedstringQueried notification capability signal.
device_realness_probe_errorbooleanWhether a realness probe errored.

DRM

FieldTypeDescription
drm_probedbooleanWhether DRM support was probed.
drm_clearkeybooleanClear Key support.
drm_widevinebooleanWidevine support.
drm_widevine_robustnessstringWidevine robustness level.
drm_externalclearkeybooleanExternal Clear Key support.
drm_fairplaybooleanFairPlay support.
drm_playreadybooleanPlayReady support.
drm_hw_secure_allbooleanHardware-secure decoding support.
drm_ua_brand_is_google_chromebooleanUA brand claims Google Chrome.
drm_errorstringDRM probe error, when one occurred.
drm_elapsed_msnumberDRM probe duration in milliseconds.

Client-provided tags

FieldTypeDescription
external_idsobjectIdentifiers you attached to the fingerprint, such as accountId, orderId, or email.
extension_presence_resultsobjectDetected browser extensions, keyed by extension.

network_client_metrics object

Connection-level TCP and TLS characteristics.

FieldTypeDescription
client_ipstringVisitor IP address.
client_portnumberVisitor source port.
user_agentstringUser agent seen at the network layer.
js_timezonestringTime zone reported by JavaScript.
timestampstringTime the network sample was taken, ISO 8601.
request_idstringRequest ID at the network layer.
protocolstringHTTP protocol used.
quic_versionnumberQUIC version, when the connection used QUIC.
syn_ip_ttlnumberIP TTL from the initial SYN packet.
syn_window_sizenumberTCP window size from the initial SYN.
syn_window_scalenumberTCP window scale from the initial SYN.
tcp_rtt_usecnumberEstimated TCP round-trip time in microseconds.
tcp_rttvar_usecnumberTCP round-trip time variance.
tcp_rtt_min_usecnumberMinimum observed TCP round-trip time.
tcp_timestampnumberTCP timestamp option value.
tcp_mss_synnumberAdvertised TCP MSS.
tcp_mss_rcvnumberObserved TCP MSS from the peer.
tls_handshake_usecnumberTLS handshake duration in microseconds.
tls_clienthello_sizenumberClientHello size in bytes.
tls_sni_formatstringSNI extension format.
tls_alpn_protocolsstring[]ALPN protocols offered in the TLS handshake.
tls_clienthello_ciphersnumber[]Offered cipher suites.
tls_clienthello_extensionsnumber[]Offered TLS extensions.
tls_clienthello_signature_algsnumber[]Offered signature algorithms.
tls_clienthello_legacy_versionnumberClientHello legacy version.
tls_clienthello_supported_versionsnumber[]Offered TLS versions.
tls_ja4stringJA4 TLS client fingerprint.
matched_againststringDomain the connection was matched against.
team_idstringYour cside team ID.

ip_enrichment object

Data derived from the visitor IP address.

FieldTypeDescription
asnnumberAutonomous System Number.
asn_namestringASN organization name.
asn_networkstringASN network range.
asn_typestringASN type, such as hosting or isp.
city_namestringCity name.
country_codestringCountry code.
country_namestringCountry name.
latitudenumberLatitude.
longitudenumberLongitude.
postal_codestringPostal code.
region_codestringRegion code.
region_namestringRegion name.
timezonestringTime zone.
hostingbooleanIP belongs to a hosting provider.
proxybooleanIP is a known proxy.
relaybooleanIP is a private relay.
torbooleanIP is a Tor exit node.
vpnbooleanIP is a known VPN.
servicestringNamed privacy service, when identified.
maxmind_asnnumberASN from MaxMind.
is_datacenter_ipbooleanIP is in a datacenter range.
is_likely_datacenternumberDatacenter likelihood score.

geo_lite_city_data object

City-level geolocation.

FieldTypeDescription
city_namestringCity name.
country_codestringCountry code.
country_namestringCountry name.
latitudenumberLatitude.
longitudenumberLongitude.
postal_codestringPostal code.
region_codestringRegion code.
region_namestringRegion name.
timezonestringTime zone.

vpn_evaluation object

VPN likelihood and supporting signals.

FieldTypeDescription
is_vpnbooleanWhether the visitor is classified as using a VPN.
vpn_probabilitynumberVPN likelihood from 0 to 1.
vpn_confidencenumberConfidence in the classification from 0 to 1.
reasonsstring[]Human-readable reasons for the classification.
featuresobjectNumeric signals used for the classification.
contextobjectEnrichment context such as reverse DNS hostname, ASN, and geo.

bot_evaluation object

Bot likelihood and verdict.

FieldTypeDescription
is_botbooleanWhether the visitor is classified as a bot.
bot_probabilitynumberBot likelihood from 0 to 1.
bot_confidencenumberConfidence in the classification from 0 to 1.
bot_agent_idstringIdentified bot, when known (for example google-googleother).
reasonsstring[]Human-readable reasons for the classification.
session_event_countnumberNumber of behavioral events processed for the session.
model_1_scorenumberScore from the first bot model (fingerprint and network signals).
model_1_thresholdnumberDecision threshold applied to the first model score.
model_2_scorenumberScore from the second bot model (behavioral signals).
model_2_thresholdnumberDecision threshold applied to the second model score.
featuresobjectNumeric signals used for the classification.

fingerprint_enrichment object

FieldTypeDescription
throwaway_email_detectedbooleanWhether an attached email uses a disposable domain.

rule_evaluations object

FieldTypeDescription
rulesobject[]Named rule outcomes. Each entry has slot, rule_id, result, metadata, and computed_at.

Example record

A single record, formatted here for readability. In the file, each record is one line.

{
  "evaluation_id": "289076244130249728",
  "customer_id": "7371466449724252160",
  "customer_domain": "shop.example.com",
  "team_id": "7196353823991660544",
  "timestamp": "2026-04-21T17:53:19.378Z",
  "page_url": "https://shop.example.com/checkout",
  "client_ip": "203.0.113.42",
  "user_agent": "Mozilla/5.0 ... Chrome/124.0 Safari/537.36",
  "evaluation_status": "EVALUATION_STATUS_COMPLETED",
  "fingerprint": {
    "device_id": "fp_dev_5c8e21",
    "browser_name": "Chrome",
    "browser_version": "124.0.0.0",
    "platform": "MacIntel",
    "timezone": "America/Los_Angeles",
    "languages": ["en-US", "en"],
    "screen_width": 1512,
    "screen_height": 982,
    "device_memory": 8,
    "external_ids": { "orderId": "txn_9931" }
  },
  "network_client_metrics": {
    "client_ip": "203.0.113.42",
    "tls_ja4": "t13d1516h2_8daaf6152771_b186095e22b6"
  },
  "geo_lite_city_data": {
    "country_code": "US",
    "city_name": "San Francisco",
    "latitude": 37.7749,
    "longitude": -122.4194
  },
  "ip_enrichment": { "asn": 13335, "asn_name": "CLOUDFLARENET", "hosting": false },
  "vpn_evaluation": { "is_vpn": false, "vpn_probability": 0.04 },
  "bot_evaluation": { "is_bot": false, "bot_probability": 0.07 }
}
Was this page helpful?