{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Verisoul","colors":{"primary":"#2160FD","light":"#2160FD","dark":"#2160FD"},"logo":{"light":"https://mintcdn.com/verisoul/PXjQD0VhqwoAY8OB/logo/light-verisoul.svg?fit=max\u0026auto=format\u0026n=PXjQD0VhqwoAY8OB\u0026q=85\u0026s=7dd6d2da064c5edd509c176e3b2f4a4a","dark":"https://mintcdn.com/verisoul/wdkmEtsUGEUd5DIj/logo/dark-verisoul.png?fit=max\u0026auto=format\u0026n=wdkmEtsUGEUd5DIj\u0026q=85\u0026s=7f718f418563bf06e61292b7b5b87b57"},"favicon":"https://mintcdn.com/verisoul/PXjQD0VhqwoAY8OB/favicon-white-border.svg?fit=max\u0026auto=format\u0026n=PXjQD0VhqwoAY8OB\u0026q=85\u0026s=44be971f8737cde09c4c97ac6267e3bf","api":{"playground":{"display":"none"}},"navbar":{"links":[{"href":"mailto:support@verisoul.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.verisoul.ai"}},"footer":{"socials":{"github":"https://github.com/verisoul","linkedin":"https://www.linkedin.com/company/verisoul-stops-fake-accounts"}},"contextual":{"options":["copy","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"verisoul","hasAudioNarration":false,"actualSubdomain":"verisoul","customDomains":["docs.verisoul.ai"],"gitSource":{"type":"github","owner":"verisoul","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aec9dae9c320f62bb69c2b7","collectionId":"ef31ca94-08be-4187-8825-5c3b5b2f64d6","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aec9dae9c320f62bb69c2b7"},"feedback":{"thumbs":false,"issues":true},"entitlements":{},"buildId":"6aec9dae9c320f62bb69c2b7","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Docs","count":68},{"language":"default","tag":"Verifications","count":34},{"language":"default","tag":"API Reference","count":27},{"language":"default","tag":"Integration","count":25},{"language":"default","tag":"Face Match","count":19},{"language":"default","tag":"ID Check","count":17},{"language":"default","tag":"Dashboard","count":14},{"language":"default","tag":"Signals \u0026 Scores","count":13},{"language":"default","tag":"Resources","count":12},{"language":"default","tag":"Intelligence","count":11}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/session/authenticate","slug":"/api-reference/session/authenticate","pageMetadata":{"title":"Authenticate Session","openapi":"session-openapi.json POST /session/authenticate","description":null,"href":"/api-reference/session/authenticate"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Authenticate Session","openapi":"session-openapi.json POST /session/authenticate","description":null,"href":"/api-reference/session/authenticate"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Authenticates a session with an account","parameters":["ac5af242-6841-4c81-bf1b-515a8a5fba06"],"requestBody":"d92efa8d-6289-4686-a7d6-44e7af413e66","responses":{"200":"9817fb6e-d7b8-4509-9ce6-00d07d2ed4aa","400":"17d314da-7e97-4530-b542-ae6db7e06ed9"},"method":"post","type":"path","servers":["a872ef37-7964-4ae9-bbeb-30dac09c7f6a"],"security":["6205af5e-8de3-4538-8364-93673a125223"],"path":"/session/authenticate","baseUrlOptions":["https://api.sandbox.verisoul.ai"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ac5af242-6841-4c81-bf1b-515a8a5fba06":{"name":"accounts_linked","in":"query","description":"Whether to include linked accounts in the response","required":false,"schema":{"type":"boolean","isRequired":false,"description":"Whether to include linked accounts in the response","uniqueKey":"","typeLabel":"boolean"}}},"requestBody":{"description":"Session authentication information","content":{"application/json":{"schema":{"type":"object","required":["account","session_id"],"properties":{"account":{"type":"object","description":"The account to authenticate. See [Account Object](/api-reference/types/account) for more information.","required":["id"],"properties":{"id":{"type":"string","description":"The account identifier","isRequired":true,"uniqueKey":"account.id","typeLabel":"string"},"email":{"type":"string","description":"The email associated with the account","uniqueKey":"account.email","typeLabel":"string"},"phone":{"type":"string","maxLength":32,"description":"The phone number on file for the account in E.164 format (e.g. +14155550123). Used for multi-accounting phone matching.","uniqueKey":"account.phone","typeLabel":"string"},"first_name":{"type":"string","maxLength":256,"description":"The account holder's first name. Combined with last_name for multi-accounting name matching.","uniqueKey":"account.first_name","typeLabel":"string"},"last_name":{"type":"string","maxLength":256,"description":"The account holder's last name. Combined with first_name for multi-accounting name matching.","uniqueKey":"account.last_name","typeLabel":"string"},"username":{"type":"string","maxLength":256,"description":"The username associated with the account. Used for multi-accounting username matching.","uniqueKey":"account.username","typeLabel":"string"},"expected_countries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2,"uniqueKey":"account.expected_countries.items.[INDEX]","typeLabel":"string"},"description":"Countries the account is expected to legitimately operate from, as ISO 3166-1 alpha-2 codes (e.g. [\"US\", \"CA\"]). A non-empty list replaces the stored list; an empty or omitted list leaves the stored list unchanged.","uniqueKey":"account.expected_countries","typeLabel":"string[]"},"metadata":{"type":"object","additionalProperties":true,"description":"Additional metadata about the account","uniqueKey":"account.metadata","typeLabel":"object"},"group":{"type":"string","description":"Groups must be enabled for the project to use this field. See [Multi Accounting Groups](/integration/advanced/multi-accounting-groups) for more information.","uniqueKey":"account.group","typeLabel":"string"},"lists":{"type":"array","items":{"type":"string","uniqueKey":"account.lists.items.[INDEX]","typeLabel":"string"},"description":"Array of list names to add the account to during authentication. Lists will be automatically created if they don't exist. See [Lists](/action/lists) for more information.","uniqueKey":"account.lists","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"account","typeLabel":"object"},"session_id":{"type":"string","description":"The ID of the session to authenticate","isRequired":true,"uniqueKey":"session_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"account":{"id":"\u003cstring>","email":"\u003cstring>","phone":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","username":"\u003cstring>","expected_countries":["\u003cstring>"],"metadata":{},"group":"\u003cstring>","lists":["\u003cstring>"]},"session_id":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"9817fb6e-d7b8-4509-9ce6-00d07d2ed4aa":{"description":"Session authentication response","content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string","description":"The ID of the project","uniqueKey":"project_id","typeLabel":"string"},"session_id":{"type":"string","description":"The ID of the session","uniqueKey":"session_id","typeLabel":"string"},"account_id":{"type":"string","description":"The ID of the account","uniqueKey":"account_id","typeLabel":"string"},"request_id":{"type":"string","description":"The ID of the request","uniqueKey":"request_id","typeLabel":"string"},"decision":{"type":"string","description":"Decision about the authenticity (Real/Fake)","uniqueKey":"decision","typeLabel":"string"},"account_score":{"type":"number","format":"float","description":"Overall account risk score","uniqueKey":"account_score","typeLabel":"number\u003cfloat>"},"bot":{"type":"number","format":"float","description":"Bot detection score","uniqueKey":"bot","typeLabel":"number\u003cfloat>"},"multiple_accounts":{"type":"number","format":"float","description":"Multiple accounts detection score","uniqueKey":"multiple_accounts","typeLabel":"number\u003cfloat>"},"risk_signals":{"type":"number","format":"float","description":"Risk signals score","uniqueKey":"risk_signals","typeLabel":"number\u003cfloat>"},"accounts_linked":{"type":"integer","description":"Number of accounts linked to this account","uniqueKey":"accounts_linked","typeLabel":"integer"},"lists":{"type":"array","items":{"type":"string","uniqueKey":"lists.items.[INDEX]","typeLabel":"string"},"description":"Lists the account belongs to","uniqueKey":"lists","typeLabel":"string[]"},"session":{"type":"object","properties":{"source":{"oneOf":[{"type":"string","enum":["web","ios","android"],"description":"SDK that produced the session. React Native and Flutter sessions report as their underlying platform. Null for sessions computed before rollout","uniqueKey":"session.source.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["web","ios","android"],"description":"SDK that produced the session. React Native and Flutter sessions report as their underlying platform. Null for sessions computed before rollout","uniqueKey":"session.source.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.source","typeLabel":"enum\u003cstring> | null"},"source_version":{"oneOf":[{"type":"string","description":"Native SDK version that produced the session (e.g. 0.4.70). Null for web sessions","uniqueKey":"session.source_version.oneOf.0","typeLabel":"string"},{"type":"null","description":"Native SDK version that produced the session (e.g. 0.4.70). Null for web sessions","uniqueKey":"session.source_version.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.source_version","typeLabel":"string | null"},"start_time":{"type":"string","format":"date-time","description":"Timestamp when the session started","uniqueKey":"session.start_time","typeLabel":"string\u003cdate-time>"},"true_country_code":{"type":"string","description":"The true country code of the session","uniqueKey":"session.true_country_code","typeLabel":"string"},"device_id":{"type":"string","description":"Device identifier from the session","uniqueKey":"session.device_id","typeLabel":"string"},"network":{"type":"object","properties":{"ip_address":{"type":"string","description":"IP address of the session","uniqueKey":"session.network.ip_address","typeLabel":"string"},"service_provider":{"type":"string","description":"Internet service provider","uniqueKey":"session.network.service_provider","typeLabel":"string"},"connection_type":{"type":"string","description":"Type of network connection","uniqueKey":"session.network.connection_type","typeLabel":"string"},"asn":{"oneOf":[{"type":"integer","description":"Autonomous system number of the session IP","uniqueKey":"session.network.asn.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Autonomous system number of the session IP","uniqueKey":"session.network.asn.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.network.asn","typeLabel":"integer | null"},"subnet":{"oneOf":[{"type":"string","description":"The /24 block the ip_reputation score was computed on (collect IPv4), e.g. 107.77.226.0/24","uniqueKey":"session.network.subnet.oneOf.0","typeLabel":"string"},{"type":"null","description":"The /24 block the ip_reputation score was computed on (collect IPv4), e.g. 107.77.226.0/24","uniqueKey":"session.network.subnet.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.network.subnet","typeLabel":"string | null"}},"uniqueKey":"session.network","typeLabel":"object"},"location":{"type":"object","properties":{"continent":{"type":"string","description":"Continent code","uniqueKey":"session.location.continent","typeLabel":"string"},"country_code":{"type":"string","description":"Country code","uniqueKey":"session.location.country_code","typeLabel":"string"},"state":{"type":"string","description":"State or region","uniqueKey":"session.location.state","typeLabel":"string"},"city":{"type":"string","description":"City name","uniqueKey":"session.location.city","typeLabel":"string"},"zip_code":{"type":"string","description":"Postal/ZIP code","uniqueKey":"session.location.zip_code","typeLabel":"string"},"timezone":{"type":"string","description":"Timezone of the location","uniqueKey":"session.location.timezone","typeLabel":"string"},"latitude":{"type":"number","format":"float","description":"Latitude coordinate","uniqueKey":"session.location.latitude","typeLabel":"number\u003cfloat>"},"longitude":{"type":"number","format":"float","description":"Longitude coordinate","uniqueKey":"session.location.longitude","typeLabel":"number\u003cfloat>"}},"uniqueKey":"session.location","typeLabel":"object"},"browser":{"type":"object","properties":{"type":{"type":"string","description":"Browser type","uniqueKey":"session.browser.type","typeLabel":"string"},"version":{"type":"string","description":"Browser version","uniqueKey":"session.browser.version","typeLabel":"string"},"language":{"type":"string","description":"Browser language setting","uniqueKey":"session.browser.language","typeLabel":"string"},"user_agent":{"type":"string","description":"User agent string","uniqueKey":"session.browser.user_agent","typeLabel":"string"},"timezone":{"type":"string","description":"Browser timezone setting","uniqueKey":"session.browser.timezone","typeLabel":"string"}},"uniqueKey":"session.browser","typeLabel":"object"},"device":{"type":"object","properties":{"category":{"type":"string","enum":["desktop","mobile","tablet","console","smarttv","wearable","embedded","other"],"description":"Device category. See [Device Categories](/signals-scores/device#device-categories) for details.","uniqueKey":"session.device.category","typeLabel":"enum\u003cstring>"},"type":{"type":"string","description":"Device type","uniqueKey":"session.device.type","typeLabel":"string"},"os":{"type":"string","description":"Operating system","uniqueKey":"session.device.os","typeLabel":"string"},"cpu_cores":{"type":"integer","description":"Number of CPU cores","uniqueKey":"session.device.cpu_cores","typeLabel":"integer"},"memory":{"type":"integer","description":"Amount of memory in GB","uniqueKey":"session.device.memory","typeLabel":"integer"},"gpu":{"type":"string","description":"GPU information","uniqueKey":"session.device.gpu","typeLabel":"string"},"screen_height":{"type":"number","description":"Screen height in pixels","uniqueKey":"session.device.screen_height","typeLabel":"number"},"screen_width":{"type":"number","description":"Screen width in pixels","uniqueKey":"session.device.screen_width","typeLabel":"number"}},"uniqueKey":"session.device","typeLabel":"object"},"bot":{"type":"object","properties":{"mouse_num_events":{"type":"integer","description":"Number of mouse events","uniqueKey":"session.bot.mouse_num_events","typeLabel":"integer"},"click_num_events":{"type":"integer","description":"Number of click events","uniqueKey":"session.bot.click_num_events","typeLabel":"integer"},"keyboard_num_events":{"type":"integer","description":"Number of keyboard events","uniqueKey":"session.bot.keyboard_num_events","typeLabel":"integer"},"touch_num_events":{"type":"integer","description":"Number of touch events","uniqueKey":"session.bot.touch_num_events","typeLabel":"integer"},"clipboard_num_events":{"type":"integer","description":"Number of clipboard events","uniqueKey":"session.bot.clipboard_num_events","typeLabel":"integer"}},"uniqueKey":"session.bot","typeLabel":"object"},"agent":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","description":"Stable agent identifier in lowercase snake_case (for example meta_muse or chatgpt_agent). Build rules on id, type and detection_method; name and provider are display values that can change","isRequired":true,"uniqueKey":"session.agent.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","description":"Plain-English agent name from the Verisoul Agent Atlas (https://agents.verisoul.ai)","isRequired":true,"uniqueKey":"session.agent.oneOf.0.name","typeLabel":"string"},"provider":{"oneOf":[{"type":"string","description":"Company or project that operates the agent. null when unknown","isRequired":true,"uniqueKey":"session.agent.oneOf.0.provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Company or project that operates the agent. null when unknown","isRequired":true,"uniqueKey":"session.agent.oneOf.0.provider.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"session.agent.oneOf.0.provider","typeLabel":"string | null"},"type":{"type":"string","enum":["ai_agent","ai_assistant","ai_crawler","crawler","headless_automation","other"],"description":"What kind of agent it is","isRequired":true,"uniqueKey":"session.agent.oneOf.0.type","typeLabel":"enum\u003cstring>"},"detection_method":{"type":"string","enum":["signed","self_declared","inferred"],"description":"How the identity was established: signed (verified Web Bot Auth signature), self_declared (named in its user agent), or inferred (a combination of signals that matches a known agent)","isRequired":true,"uniqueKey":"session.agent.oneOf.0.detection_method","typeLabel":"enum\u003cstring>"},"detection_signals":{"type":"array","items":{"type":"string","enum":["cryptographic","network","device","behavioral"],"uniqueKey":"session.agent.oneOf.0.detection_signals.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"The combination of signals used for detection","isRequired":true,"uniqueKey":"session.agent.oneOf.0.detection_signals","typeLabel":"enum\u003cstring>[]"}},"required":["id","name","provider","type","detection_method","detection_signals"],"description":"The identified AI agent, assistant, crawler or automation tool. null when no agent was identified","uniqueKey":"session.agent.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"id":{"type":"string","description":"Stable agent identifier in lowercase snake_case (for example meta_muse or chatgpt_agent). Build rules on id, type and detection_method; name and provider are display values that can change"},"name":{"type":"string","description":"Plain-English agent name from the Verisoul Agent Atlas (https://agents.verisoul.ai)"},"provider":{"oneOf":[{"type":"string","description":"Company or project that operates the agent. null when unknown"},{"type":"null","description":"Company or project that operates the agent. null when unknown"}]},"type":{"type":"string","enum":["ai_agent","ai_assistant","ai_crawler","crawler","headless_automation","other"],"description":"What kind of agent it is"},"detection_method":{"type":"string","enum":["signed","self_declared","inferred"],"description":"How the identity was established: signed (verified Web Bot Auth signature), self_declared (named in its user agent), or inferred (a combination of signals that matches a known agent)"},"detection_signals":{"type":"array","items":{"type":"string","enum":["cryptographic","network","device","behavioral"]},"description":"The combination of signals used for detection"}},"required":["id","name","provider","type","detection_method","detection_signals"],"description":"The identified AI agent, assistant, crawler or automation tool. null when no agent was identified","uniqueKey":"session.agent.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.agent","typeLabel":"object | null"},"risk_signals":{"type":"object","properties":{"device_risk":{"type":"boolean","description":"Device risk flag","uniqueKey":"session.risk_signals.device_risk","typeLabel":"boolean"},"proxy":{"type":"boolean","description":"Proxy usage flag","uniqueKey":"session.risk_signals.proxy","typeLabel":"boolean"},"vpn":{"type":"boolean","description":"VPN usage flag","uniqueKey":"session.risk_signals.vpn","typeLabel":"boolean"},"tor":{"type":"boolean","description":"Tor usage flag","uniqueKey":"session.risk_signals.tor","typeLabel":"boolean"},"spoofed_ip":{"type":"boolean","description":"Spoofed IP flag","uniqueKey":"session.risk_signals.spoofed_ip","typeLabel":"boolean"},"datacenter":{"type":"boolean","description":"Datacenter IP flag","uniqueKey":"session.risk_signals.datacenter","typeLabel":"boolean"},"recent_fraud_ip":{"type":"boolean","description":"Recent fraud IP flag","uniqueKey":"session.risk_signals.recent_fraud_ip","typeLabel":"boolean"},"impossible_travel":{"type":"boolean","description":"Impossible travel flag","uniqueKey":"session.risk_signals.impossible_travel","typeLabel":"boolean"},"device_network_mismatch":{"type":"boolean","description":"Device network mismatch flag","uniqueKey":"session.risk_signals.device_network_mismatch","typeLabel":"boolean"},"location_spoofing":{"type":"boolean","description":"Location spoofing flag","uniqueKey":"session.risk_signals.location_spoofing","typeLabel":"boolean"},"ip_reputation":{"type":"boolean","description":"Block reputation flag: ip_reputation score above 0.5","uniqueKey":"session.risk_signals.ip_reputation","typeLabel":"boolean"}},"uniqueKey":"session.risk_signals","typeLabel":"object"},"risk_signal_scores":{"type":"object","properties":{"device_risk":{"type":"number","format":"float","description":"Device risk score","uniqueKey":"session.risk_signal_scores.device_risk","typeLabel":"number\u003cfloat>"},"proxy":{"type":"number","format":"float","description":"Proxy detection score","uniqueKey":"session.risk_signal_scores.proxy","typeLabel":"number\u003cfloat>"},"vpn":{"type":"number","format":"float","description":"VPN detection score","uniqueKey":"session.risk_signal_scores.vpn","typeLabel":"number\u003cfloat>"},"tor":{"type":"number","format":"float","description":"Tor detection score","uniqueKey":"session.risk_signal_scores.tor","typeLabel":"number\u003cfloat>"},"datacenter":{"type":"number","format":"float","description":"Datacenter detection score","uniqueKey":"session.risk_signal_scores.datacenter","typeLabel":"number\u003cfloat>"},"recent_fraud_ip":{"type":"number","format":"float","description":"Recent fraud IP detection score","uniqueKey":"session.risk_signal_scores.recent_fraud_ip","typeLabel":"number\u003cfloat>"},"impossible_travel":{"type":"number","format":"float","description":"Impossible travel detection score","uniqueKey":"session.risk_signal_scores.impossible_travel","typeLabel":"number\u003cfloat>"},"device_network_mismatch":{"type":"number","format":"float","description":"Device network mismatch score","uniqueKey":"session.risk_signal_scores.device_network_mismatch","typeLabel":"number\u003cfloat>"},"location_spoofing":{"type":"number","format":"float","description":"Location spoofing detection score","uniqueKey":"session.risk_signal_scores.location_spoofing","typeLabel":"number\u003cfloat>"},"ip_reputation":{"type":"number","description":"Reputation of the network block behind the IP, -1 (trusted) to 1 (risky); 0 when the block has no history","format":"float","minimum":-1,"maximum":1,"uniqueKey":"session.risk_signal_scores.ip_reputation","typeLabel":"number\u003cfloat>"}},"uniqueKey":"session.risk_signal_scores","typeLabel":"object"},"risk_signal_details":{"type":"object","properties":{"network":{"type":"array","items":{"type":"string","uniqueKey":"session.risk_signal_details.network.items.[INDEX]","typeLabel":"string"},"description":"See [Risk Signal Details](/signals-scores/risk-signals) for descriptions.","uniqueKey":"session.risk_signal_details.network","typeLabel":"string[]"},"device":{"type":"array","items":{"type":"string","uniqueKey":"session.risk_signal_details.device.items.[INDEX]","typeLabel":"string"},"description":"See [Risk Signal Details](/signals-scores/risk-signals) for descriptions.","uniqueKey":"session.risk_signal_details.device","typeLabel":"string[]"}},"uniqueKey":"session.risk_signal_details","typeLabel":"object"},"mobile":{"type":"object","properties":{"brand":{"oneOf":[{"type":"string","description":"Device brand as reported by the native SDK (e.g. Apple, samsung)","uniqueKey":"session.mobile.brand.oneOf.0","typeLabel":"string"},{"type":"null","description":"Device brand as reported by the native SDK (e.g. Apple, samsung)","uniqueKey":"session.mobile.brand.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.mobile.brand","typeLabel":"string | null"},"model":{"oneOf":[{"type":"string","description":"Device model as reported by the native SDK","uniqueKey":"session.mobile.model.oneOf.0","typeLabel":"string"},{"type":"null","description":"Device model as reported by the native SDK","uniqueKey":"session.mobile.model.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.mobile.model","typeLabel":"string | null"},"system_memory_gb":{"oneOf":[{"type":"integer","description":"Total device RAM in GB. Null on Android (not collected by the SDK yet)","uniqueKey":"session.mobile.system_memory_gb.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Total device RAM in GB. Null on Android (not collected by the SDK yet)","uniqueKey":"session.mobile.system_memory_gb.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.mobile.system_memory_gb","typeLabel":"integer | null"},"boot_count":{"oneOf":[{"type":"integer","description":"Device boot count. Null on iOS (not exposed by the platform)","uniqueKey":"session.mobile.boot_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Device boot count. Null on iOS (not exposed by the platform)","uniqueKey":"session.mobile.boot_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.mobile.boot_count","typeLabel":"integer | null"},"system_uptime_days":{"oneOf":[{"type":"number","description":"Days since the device last booted","format":"float","uniqueKey":"session.mobile.system_uptime_days.oneOf.0","typeLabel":"number\u003cfloat>"},{"type":"null","description":"Days since the device last booted","format":"float","uniqueKey":"session.mobile.system_uptime_days.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.mobile.system_uptime_days","typeLabel":"number\u003cfloat> | null"},"battery_level":{"oneOf":[{"type":"number","description":"Battery level between 0 and 1. Null on Android (not collected by the SDK yet)","format":"float","uniqueKey":"session.mobile.battery_level.oneOf.0","typeLabel":"number\u003cfloat>"},{"type":"null","description":"Battery level between 0 and 1. Null on Android (not collected by the SDK yet)","format":"float","uniqueKey":"session.mobile.battery_level.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.mobile.battery_level","typeLabel":"number\u003cfloat> | null"},"languages":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"session.mobile.languages.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Device language preferences (e.g. [\"en-US\"])","uniqueKey":"session.mobile.languages.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Device language preferences (e.g. [\"en-US\"])","uniqueKey":"session.mobile.languages.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.mobile.languages","typeLabel":"string[] | null"},"oem_app_integrity":{"oneOf":[{"type":"string","description":"OEM app integrity verdict: passed, failed, or unavailable","uniqueKey":"session.mobile.oem_app_integrity.oneOf.0","typeLabel":"string"},{"type":"null","description":"OEM app integrity verdict: passed, failed, or unavailable","uniqueKey":"session.mobile.oem_app_integrity.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.mobile.oem_app_integrity","typeLabel":"string | null"},"oem_device_integrity":{"oneOf":[{"type":"string","description":"OEM device integrity verdict: passed, failed, or unavailable","uniqueKey":"session.mobile.oem_device_integrity.oneOf.0","typeLabel":"string"},{"type":"null","description":"OEM device integrity verdict: passed, failed, or unavailable","uniqueKey":"session.mobile.oem_device_integrity.oneOf.1","typeLabel":"null"}],"uniqueKey":"session.mobile.oem_device_integrity","typeLabel":"string | null"}},"description":"Native mobile SDK device facts. An empty object for sessions that did not come from the native iOS/Android SDK.","uniqueKey":"session.mobile","typeLabel":"object"}},"uniqueKey":"session","typeLabel":"object"},"account":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"string","description":"The account identifier","uniqueKey":"account.account.id","typeLabel":"string"},"email":{"type":"string","description":"The email associated with the account","uniqueKey":"account.account.email","typeLabel":"string"},"phone":{"type":"string","description":"The phone number stored for the account in E.164 format","uniqueKey":"account.account.phone","typeLabel":"string"},"first_name":{"type":"string","description":"The account holder's first name","uniqueKey":"account.account.first_name","typeLabel":"string"},"last_name":{"type":"string","description":"The account holder's last name","uniqueKey":"account.account.last_name","typeLabel":"string"},"username":{"type":"string","description":"The username stored for the account","uniqueKey":"account.account.username","typeLabel":"string"},"expected_countries":{"type":"array","items":{"type":"string","uniqueKey":"account.account.expected_countries.items.[INDEX]","typeLabel":"string"},"description":"Countries the account is expected to operate from (ISO 3166-1 alpha-2 codes)","uniqueKey":"account.account.expected_countries","typeLabel":"string[]"},"metadata":{"type":"object","additionalProperties":true,"description":"Additional metadata about the account","uniqueKey":"account.account.metadata","typeLabel":"object"},"group":{"type":"string","description":"The group associated with the account","uniqueKey":"account.account.group","typeLabel":"string"}},"uniqueKey":"account.account","typeLabel":"object"},"num_sessions":{"type":"integer","description":"Number of sessions associated with this account","uniqueKey":"account.num_sessions","typeLabel":"integer"},"first_seen":{"type":"string","format":"date-time","description":"Timestamp when the account was first seen","uniqueKey":"account.first_seen","typeLabel":"string\u003cdate-time>"},"last_seen":{"type":"string","format":"date-time","description":"Timestamp when the account was last seen","uniqueKey":"account.last_seen","typeLabel":"string\u003cdate-time>"},"last_session":{"type":"string","description":"ID of the last session","uniqueKey":"account.last_session","typeLabel":"string"},"country":{"type":"string","description":"Country code of the account","uniqueKey":"account.country","typeLabel":"string"},"countries":{"type":"array","items":{"type":"string","uniqueKey":"account.countries.items.[INDEX]","typeLabel":"string"},"description":"List of countries associated with this account","uniqueKey":"account.countries","typeLabel":"string[]"},"unique_devices":{"type":"object","properties":{"1_day":{"type":"integer","description":"Number of unique devices in the last day","uniqueKey":"account.unique_devices.1_day","typeLabel":"integer"},"7_day":{"type":"integer","description":"Number of unique devices in the last 7 days","uniqueKey":"account.unique_devices.7_day","typeLabel":"integer"}},"uniqueKey":"account.unique_devices","typeLabel":"object"},"unique_networks":{"type":"object","properties":{"1_day":{"type":"integer","description":"Number of unique networks in the last day","uniqueKey":"account.unique_networks.1_day","typeLabel":"integer"},"7_day":{"type":"integer","description":"Number of unique networks in the last 7 days","uniqueKey":"account.unique_networks.7_day","typeLabel":"integer"}},"uniqueKey":"account.unique_networks","typeLabel":"object"},"email":{"type":"object","properties":{"email":{"type":"string","description":"Email address","uniqueKey":"account.email.email","typeLabel":"string"},"disposable":{"type":"boolean","description":"Whether the email is disposable","uniqueKey":"account.email.disposable","typeLabel":"boolean"},"personal":{"type":"boolean","description":"Whether the email is personal","uniqueKey":"account.email.personal","typeLabel":"boolean"},"valid":{"type":"boolean","description":"Whether the email is valid","uniqueKey":"account.email.valid","typeLabel":"boolean"},"domain_type":{"type":"string","enum":["relay","personal","disposable","business","government","education","invalid","not_active"],"description":"The type of domain. See [Domain Types](/signals-scores/email#domain-types) for details.","uniqueKey":"account.email.domain_type","typeLabel":"enum\u003cstring>"},"email_score":{"type":"number","format":"float","description":"Email risk score from -1 (most trustworthy) to 1 (most risky)","uniqueKey":"account.email.email_score","typeLabel":"number\u003cfloat>"},"trust_signals":{"type":"array","items":{"type":"string","uniqueKey":"account.email.trust_signals.items.[INDEX]","typeLabel":"string"},"description":"Array of trust signals detected for this email. See [Trust Flags](/signals-scores/email#trust-flags) for descriptions.","uniqueKey":"account.email.trust_signals","typeLabel":"string[]"},"risk_signals":{"type":"array","items":{"type":"string","uniqueKey":"account.email.risk_signals.items.[INDEX]","typeLabel":"string"},"description":"Array of risk signals detected for this email. See [Risk Flags](/signals-scores/email#risk-flags) for descriptions.","uniqueKey":"account.email.risk_signals","typeLabel":"string[]"},"num_account_from_domain":{"type":"integer","description":"Number of accounts from the same apex domain seen in your project. Capped at 1000. See [Domain Account Velocity](/signals-scores/email#domain-account-velocity) for details.","uniqueKey":"account.email.num_account_from_domain","typeLabel":"integer"}},"uniqueKey":"account.email","typeLabel":"object"},"risk_signal_average":{"type":"object","properties":{"device_risk":{"type":"number","format":"float","description":"Device risk score","uniqueKey":"account.risk_signal_average.device_risk","typeLabel":"number\u003cfloat>"},"proxy":{"type":"number","format":"float","description":"Proxy detection score","uniqueKey":"account.risk_signal_average.proxy","typeLabel":"number\u003cfloat>"},"vpn":{"type":"number","format":"float","description":"VPN detection score","uniqueKey":"account.risk_signal_average.vpn","typeLabel":"number\u003cfloat>"},"tor":{"type":"number","format":"float","description":"Tor detection score","uniqueKey":"account.risk_signal_average.tor","typeLabel":"number\u003cfloat>"},"spoofed_ip":{"type":"number","format":"float","description":"Spoofed IP detection score","uniqueKey":"account.risk_signal_average.spoofed_ip","typeLabel":"number\u003cfloat>"},"datacenter":{"type":"number","format":"float","description":"Datacenter detection score","uniqueKey":"account.risk_signal_average.datacenter","typeLabel":"number\u003cfloat>"},"recent_fraud_ip":{"type":"number","format":"float","description":"Recent fraud IP detection score","uniqueKey":"account.risk_signal_average.recent_fraud_ip","typeLabel":"number\u003cfloat>"},"impossible_travel":{"type":"number","format":"float","description":"Impossible travel detection score","uniqueKey":"account.risk_signal_average.impossible_travel","typeLabel":"number\u003cfloat>"},"device_network_mismatch":{"type":"number","format":"float","description":"Device network mismatch score","uniqueKey":"account.risk_signal_average.device_network_mismatch","typeLabel":"number\u003cfloat>"},"location_spoofing":{"type":"number","format":"float","description":"Location spoofing detection score","uniqueKey":"account.risk_signal_average.location_spoofing","typeLabel":"number\u003cfloat>"}},"uniqueKey":"account.risk_signal_average","typeLabel":"object"}},"uniqueKey":"account","typeLabel":"object"},"linked_accounts":{"type":"array","items":{"type":"object","properties":{"account_id":{"type":"string","description":"The ID of the linked account","uniqueKey":"linked_accounts.items.[INDEX].account_id","typeLabel":"string"},"score":{"type":"number","format":"float","description":"Confidence score of the link between accounts","uniqueKey":"linked_accounts.items.[INDEX].score","typeLabel":"number\u003cfloat>"},"email":{"type":"string","description":"Email associated with the linked account","uniqueKey":"linked_accounts.items.[INDEX].email","typeLabel":"string"},"phone":{"type":"string","description":"Phone number associated with the linked account","uniqueKey":"linked_accounts.items.[INDEX].phone","typeLabel":"string"},"first_name":{"type":"string","description":"First name associated with the linked account","uniqueKey":"linked_accounts.items.[INDEX].first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Last name associated with the linked account","uniqueKey":"linked_accounts.items.[INDEX].last_name","typeLabel":"string"},"username":{"type":"string","description":"Username associated with the linked account","uniqueKey":"linked_accounts.items.[INDEX].username","typeLabel":"string"},"expected_countries":{"type":"array","items":{"type":"string","uniqueKey":"linked_accounts.items.[INDEX].expected_countries.items.[INDEX]","typeLabel":"string"},"description":"Expected countries declared for the linked account (ISO 3166-1 alpha-2 codes)","uniqueKey":"linked_accounts.items.[INDEX].expected_countries","typeLabel":"string[]"},"first_seen":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp when the linked account was first seen","uniqueKey":"linked_accounts.items.[INDEX].first_seen.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp when the linked account was first seen","uniqueKey":"linked_accounts.items.[INDEX].first_seen.oneOf.1","typeLabel":"null"}],"uniqueKey":"linked_accounts.items.[INDEX].first_seen","typeLabel":"string\u003cdate-time> | null"},"last_seen":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp when the linked account was last seen","uniqueKey":"linked_accounts.items.[INDEX].last_seen.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp when the linked account was last seen","uniqueKey":"linked_accounts.items.[INDEX].last_seen.oneOf.1","typeLabel":"null"}],"uniqueKey":"linked_accounts.items.[INDEX].last_seen","typeLabel":"string\u003cdate-time> | null"},"match_type":{"type":"array","items":{"type":"string","uniqueKey":"linked_accounts.items.[INDEX].match_type.items.[INDEX]","typeLabel":"string"},"description":"Types of matches that linked these accounts. Possible values: browser, device, network, email, phone, username, name, mobile_id, apple_device_check.","uniqueKey":"linked_accounts.items.[INDEX].match_type","typeLabel":"string[]"},"lists":{"type":"array","items":{"type":"string","uniqueKey":"linked_accounts.items.[INDEX].lists.items.[INDEX]","typeLabel":"string"},"description":"Lists the linked account belongs to","uniqueKey":"linked_accounts.items.[INDEX].lists","typeLabel":"string[]"},"metadata":{"type":"object","additionalProperties":true,"description":"Additional metadata about the linked account","uniqueKey":"linked_accounts.items.[INDEX].metadata","typeLabel":"object"}},"uniqueKey":"linked_accounts.items.[INDEX]","typeLabel":"object"},"description":"List of accounts linked to the authenticated account (only included when accounts_linked=true)","uniqueKey":"linked_accounts","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"default":{"title":"default","value":{"project_id":"00000000-0000-0000-0000-000000000001","session_id":"7fd9d3e5-a5d3-4e47-9c2a-69fd8f0e0bd7","account_id":"john-doe","request_id":"055ce1fc-0219-4909-9cb4-091be9d374d6","decision":"Real","account_score":0.17,"bot":0,"multiple_accounts":0,"risk_signals":0.17,"accounts_linked":0,"lists":["us_users"],"session":{"source":"ios","source_version":"0.4.70","start_time":"2025-06-10T16:35:22.184Z","true_country_code":"US","device_id":"6yONB4zT6k2i7SXvWkwC9s","network":{"ip_address":"107.209.253.92","service_provider":"AT\u0026T Internet","connection_type":"isp","asn":7018,"subnet":"107.209.253.0/24"},"location":{"continent":"NA","country_code":"US","state":"Texas","city":"Austin","zip_code":"78729","timezone":"America/Chicago","latitude":30.3773,"longitude":-97.71},"browser":{"type":"Chrome","version":"137.0.0.0","language":"en-US","user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","timezone":"America/Chicago"},"device":{"category":"desktop","type":"Mac","os":"macOS 10.15.7","cpu_cores":16,"memory":8,"gpu":"ANGLE (Apple, ANGLE Metal Renderer: Apple M4 Max, Unspecified Version)","screen_height":1329,"screen_width":2056},"bot":{"mouse_num_events":0,"click_num_events":0,"keyboard_num_events":0,"touch_num_events":0,"clipboard_num_events":0},"agent":null,"risk_signals":{"device_risk":false,"proxy":false,"vpn":false,"tor":false,"spoofed_ip":false,"datacenter":false,"recent_fraud_ip":false,"impossible_travel":false,"device_network_mismatch":false,"location_spoofing":false,"ip_reputation":false},"risk_signal_scores":{"device_risk":0.1431,"proxy":0,"vpn":0,"tor":0,"datacenter":0,"recent_fraud_ip":0,"impossible_travel":0,"device_network_mismatch":0.0001,"location_spoofing":0,"ip_reputation":0.0113},"risk_signal_details":{"network":[],"device":[]},"mobile":{"brand":"Apple","model":"iPhone","system_memory_gb":8,"boot_count":null,"system_uptime_days":2,"battery_level":0.82,"languages":["en-US"],"oem_app_integrity":"unavailable","oem_device_integrity":"passed"}},"account":{"account":{"id":"john-doe","email":"johndoe.example@gmail.com","metadata":{},"group":""},"num_sessions":3,"first_seen":"2025-06-10T16:35:22.184Z","last_seen":"2025-06-10T16:35:52.018Z","last_session":"7fd9d3e5-a5d3-4e47-9c2a-69fd8f0e0bd7","country":"US","countries":["US"],"unique_devices":{"1_day":1,"7_day":1},"unique_networks":{"1_day":1,"7_day":1},"email":{"email":"johndoe.example@gmail.com","disposable":false,"personal":true,"valid":true,"domain_type":"personal","email_score":0,"trust_signals":["email_age_greater_than_5_years","email_known_online_history"],"risk_signals":["email_alias"],"num_account_from_domain":156},"risk_signal_average":{"device_risk":0.2266,"proxy":0,"vpn":0,"tor":0,"spoofed_ip":0,"datacenter":0,"recent_fraud_ip":0,"impossible_travel":0,"device_network_mismatch":0.0001,"location_spoofing":0}}}},"with accounts_linked":{"title":"with accounts_linked","value":{"project_id":"00000000-0000-0000-0000-000000000001","session_id":"7fd9d3e5-a5d3-4e47-9c2a-69fd8f0e0bd7","account_id":"john-doe-2","request_id":"055ce1fc-0219-4909-9cb4-091be9d374d6","decision":"Real","account_score":0.17,"bot":0,"multiple_accounts":0,"risk_signals":0.17,"accounts_linked":0,"lists":["us_users"],"session":{"source":"web","source_version":null,"start_time":"2025-06-10T16:35:22.184Z","true_country_code":"US","device_id":"6yONB4zT6k2i7SXvWkwC9s","network":{"ip_address":"107.209.253.92","service_provider":"AT\u0026T Internet","connection_type":"isp","asn":7018,"subnet":"107.209.253.0/24"},"location":{"continent":"NA","country_code":"US","state":"Texas","city":"Austin","zip_code":"78729","timezone":"America/Chicago","latitude":30.3773,"longitude":-97.71},"browser":{"type":"Chrome","version":"137.0.0.0","language":"en-US","user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","timezone":"America/Chicago"},"device":{"category":"desktop","type":"Mac","os":"macOS 10.15.7","cpu_cores":16,"memory":8,"gpu":"ANGLE (Apple, ANGLE Metal Renderer: Apple M4 Max, Unspecified Version)","screen_height":1329,"screen_width":2056},"bot":{"mouse_num_events":0,"click_num_events":0,"keyboard_num_events":0,"touch_num_events":0,"clipboard_num_events":0},"agent":null,"risk_signals":{"device_risk":false,"proxy":false,"vpn":false,"tor":false,"spoofed_ip":false,"datacenter":false,"recent_fraud_ip":false,"impossible_travel":false,"device_network_mismatch":false,"location_spoofing":false,"ip_reputation":false},"risk_signal_scores":{"device_risk":0.1431,"proxy":0,"vpn":0,"tor":0,"datacenter":0,"recent_fraud_ip":0,"impossible_travel":0,"device_network_mismatch":0.0001,"location_spoofing":0,"ip_reputation":0.0113},"risk_signal_details":{"network":[],"device":[]},"mobile":{}},"account":{"account":{"id":"john-doe","email":"johndoe.example@gmail.com","metadata":{},"group":""},"num_sessions":3,"first_seen":"2025-06-10T16:35:22.184Z","last_seen":"2025-06-10T16:35:52.018Z","last_session":"7fd9d3e5-a5d3-4e47-9c2a-69fd8f0e0bd7","country":"US","countries":["US"],"unique_devices":{"1_day":1,"7_day":1},"unique_networks":{"1_day":1,"7_day":1},"email":{"email":"johndoe.example@gmail.com","disposable":false,"personal":true,"valid":true,"domain_type":"personal","email_score":0,"trust_signals":["email_age_greater_than_5_years","email_known_online_history"],"risk_signals":["email_alias"],"num_account_from_domain":156},"risk_signal_average":{"device_risk":0.2266,"proxy":0,"vpn":0,"tor":0,"spoofed_ip":0,"datacenter":0,"recent_fraud_ip":0,"impossible_travel":0,"device_network_mismatch":0.0001,"location_spoofing":0}},"linked_accounts":[{"account_id":"john-doe-2","score":1,"email":"john.doe2@example.com","phone":"+14155550123","first_name":"Jane","last_name":"Doe","username":"jane.doe","expected_countries":["US","CA"],"first_seen":"2025-06-10T16:47:29.661Z","last_seen":"2025-12-03T08:21:14.902Z","match_type":["browser","network","email","phone","username"],"lists":["us_users"],"metadata":{}},{"account_id":"alice-2","score":0.17,"email":"alice.2@example.com","phone":"+14155550123","first_name":"Jane","last_name":"Doe","username":"jane.doe","expected_countries":["US","CA"],"first_seen":"2025-08-21T09:12:04.118Z","last_seen":"2025-12-15T19:45:52.330Z","match_type":["network"],"lists":["us_users"],"metadata":{}}]}},"with agent":{"title":"with agent","value":{"project_id":"00000000-0000-0000-0000-000000000001","session_id":"7fd9d3e5-a5d3-4e47-9c2a-69fd8f0e0bd7","account_id":"john-doe","request_id":"055ce1fc-0219-4909-9cb4-091be9d374d6","decision":"Suspicious","account_score":0.81,"bot":0.97,"multiple_accounts":0,"risk_signals":0.17,"accounts_linked":0,"lists":["us_users"],"session":{"source":"ios","source_version":"0.4.70","start_time":"2025-06-10T16:35:22.184Z","true_country_code":"US","device_id":"6yONB4zT6k2i7SXvWkwC9s","network":{"ip_address":"34.82.141.27","service_provider":"Google LLC","connection_type":"corporate_bot","asn":396982,"subnet":"34.82.141.0/24"},"location":{"continent":"NA","country_code":"US","state":"Texas","city":"Austin","zip_code":"78729","timezone":"America/Chicago","latitude":30.3773,"longitude":-97.71},"browser":{"type":"Chrome","version":"137.0.0.0","language":"en-US","user_agent":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","timezone":"America/Chicago"},"device":{"category":"desktop","type":"Linux","os":"Linux","cpu_cores":8,"memory":8,"gpu":"ANGLE (Intel, Mesa Intel(R) UHD Graphics 630 (CFL GT2), OpenGL 4.6)","screen_height":1080,"screen_width":1920},"bot":{"mouse_num_events":0,"click_num_events":3,"keyboard_num_events":12,"touch_num_events":0,"clipboard_num_events":0},"agent":{"id":"grok_bot","name":"Grok Bot","provider":"xAI","type":"ai_assistant","detection_method":"signed","detection_signals":["cryptographic","behavioral"]},"risk_signals":{"device_risk":false,"proxy":false,"vpn":false,"tor":false,"spoofed_ip":false,"datacenter":false,"recent_fraud_ip":false,"impossible_travel":false,"device_network_mismatch":false,"location_spoofing":false,"ip_reputation":false},"risk_signal_scores":{"device_risk":0.1431,"proxy":0,"vpn":0,"tor":0,"datacenter":0,"recent_fraud_ip":0,"impossible_travel":0,"device_network_mismatch":0.0001,"location_spoofing":0,"ip_reputation":0.0113},"risk_signal_details":{"network":[],"device":[]},"mobile":{"brand":"Apple","model":"iPhone","system_memory_gb":8,"boot_count":null,"system_uptime_days":2,"battery_level":0.82,"languages":["en-US"],"oem_app_integrity":"unavailable","oem_device_integrity":"passed"}},"account":{"account":{"id":"john-doe","email":"johndoe.example@gmail.com","metadata":{},"group":""},"num_sessions":3,"first_seen":"2025-06-10T16:35:22.184Z","last_seen":"2025-06-10T16:35:52.018Z","last_session":"7fd9d3e5-a5d3-4e47-9c2a-69fd8f0e0bd7","country":"US","countries":["US"],"unique_devices":{"1_day":1,"7_day":1},"unique_networks":{"1_day":1,"7_day":1},"email":{"email":"johndoe.example@gmail.com","disposable":false,"personal":true,"valid":true,"domain_type":"personal","email_score":0,"trust_signals":["email_age_greater_than_5_years","email_known_online_history"],"risk_signals":["email_alias"],"num_account_from_domain":156},"risk_signal_average":{"device_risk":0.2266,"proxy":0,"vpn":0,"tor":0,"spoofed_ip":0,"datacenter":0,"recent_fraud_ip":0,"impossible_travel":0,"device_network_mismatch":0.0001,"location_spoofing":0}}}}},"exampleType":"examples"}},"exampleType":"examples"},"17d314da-7e97-4530-b542-ae6db7e06ed9":{"description":"Session not found or invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","description":"HTTP status code","uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","description":"Error message","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":400,"message":"Session ID not found"},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"message":"Session ID not found"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"6205af5e-8de3-4538-8364-93673a125223":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"a872ef37-7964-4ae9-bbeb-30dac09c7f6a":{"url":"https://api.sandbox.verisoul.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"api-reference/session-openapi.json"},"subdomain":"verisoul","siteName":"Verisoul","title":"Authenticate Session - Verisoul","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T18:01:22.055Z","originalFileLocation":"api-reference/session/authenticate.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Verisoul\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/verisoul/tgpe8fUEJwaOmY1H/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/verisoul/tgpe8fUEJwaOmY1H/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/verisoul/tgpe8fUEJwaOmY1H/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/verisoul/tgpe8fUEJwaOmY1H/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/verisoul/tgpe8fUEJwaOmY1H/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/verisoul/tgpe8fUEJwaOmY1H/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/verisoul/tgpe8fUEJwaOmY1H/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/verisoul/tgpe8fUEJwaOmY1H/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/verisoul/tgpe8fUEJwaOmY1H/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authenticate Session - Verisoul\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Verisoul\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.verisoul.ai/api-reference/session/authenticate\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://verisoul.mintlify.app/_mintlify/api/og/v2?division=Session\u0026amp;title=Authenticate+Session\u0026amp;theme=e974d24437110b0afb79acdd\u0026amp;signature=ca2d7eed8f292b02d9ca14be70ae26c700e2bbcbc3bdf6f58b44312168d7a527\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Authenticate Session - Verisoul\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://verisoul.mintlify.app/_mintlify/api/og/v2?division=Session\u0026amp;title=Authenticate+Session\u0026amp;theme=e974d24437110b0afb79acdd\u0026amp;signature=ca2d7eed8f292b02d9ca14be70ae26c700e2bbcbc3bdf6f58b44312168d7a527\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/verisoul/tgpe8fUEJwaOmY1H/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Verisoul\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2160FD\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.verisoul.ai/api-reference/session/authenticate\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/session/authenticate.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.verisoul.ai/#organization\",\"name\":\"Verisoul\",\"url\":\"https://docs.verisoul.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/verisoul/PXjQD0VhqwoAY8OB/logo/light-verisoul.svg?fit=max\u0026auto=format\u0026n=PXjQD0VhqwoAY8OB\u0026q=85\u0026s=7dd6d2da064c5edd509c176e3b2f4a4a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.verisoul.ai#website\",\"name\":\"Verisoul\",\"url\":\"https://docs.verisoul.ai\",\"publisher\":{\"@id\":\"https://docs.verisoul.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.verisoul.ai/api-reference/session/authenticate#webpage\",\"url\":\"https://docs.verisoul.ai/api-reference/session/authenticate\",\"name\":\"Authenticate Session\",\"dateModified\":\"2026-11-03T18:01:22.055Z\",\"isPartOf\":{\"@id\":\"https://docs.verisoul.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.verisoul.ai/api-reference/session/authenticate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.verisoul.ai/api-reference/session/authenticate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Verisoul\",\"item\":\"https://docs.verisoul.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authenticate Session\",\"item\":\"https://docs.verisoul.ai/api-reference/session/authenticate\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.verisoul.ai/api-reference/session/authenticate#apireference\",\"headline\":\"Authenticate Session\",\"name\":\"Authenticate Session\",\"url\":\"https://docs.verisoul.ai/api-reference/session/authenticate\",\"mainEntityOfPage\":{\"@id\":\"https://docs.verisoul.ai/api-reference/session/authenticate#webpage\"},\"dateModified\":\"2026-11-03T18:01:22.055Z\",\"publisher\":{\"@id\":\"https://docs.verisoul.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.verisoul.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Verisoul\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Verisoul","nav":{"global":{},"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/overview/how-verisoul-works"}]},{"tab":"Dashboard","pages":[{"title":"Dashboard","href":"/dashboard/overview"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Overview","href":"/api-reference/introduction"},{"title":"Rate Limits","description":null,"href":"/api-reference/rate-limits"}]},{"group":"Session","pages":[{"title":"Authenticate Session","openapi":"session-openapi.json POST /session/authenticate","href":"/api-reference/session/authenticate"},{"title":"Get Session","openapi":"session-openapi.json GET /session/{session_id}","description":null,"href":"/api-reference/session/get"}]},{"group":"Account","pages":[{"title":"Get Account","openapi":"account-openapi.json GET /account/{account_id}","href":"/api-reference/account/get"},{"title":"Get Account Sessions","openapi":"account-openapi.json GET /account/{account_id}/sessions","href":"/api-reference/account/get-account-sessions"},{"title":"Get Linked Accounts","openapi":"account-openapi.json GET /account/{account_id}/accounts-linked","href":"/api-reference/account/get-accounts-linked"},{"title":"Update Account","openapi":"account-openapi.json PUT /account/{account_id}","href":"/api-reference/account/update"},{"title":"Delete Account","openapi":"account-openapi.json DELETE /account/{account_id}","href":"/api-reference/account/delete"}]},{"group":"Lists","pages":[{"title":"Create List","openapi":"list-openapi.json POST /list/{list_name}","href":"/api-reference/lists/create"},{"title":"Add Account to List","openapi":"list-openapi.json POST /list/{list_name}/account/{account_id}","href":"/api-reference/lists/add-account"},{"title":"Get List","openapi":"list-openapi.json GET /list","href":"/api-reference/lists/get"},{"title":"Get All Accounts in List","openapi":"list-openapi.json GET /list/{list_name}","href":"/api-reference/lists/get-all-accounts-in-list"},{"title":"Delete List","openapi":"list-openapi.json DELETE /list/{list_name}","href":"/api-reference/lists/delete"},{"title":"Remove Account from List","openapi":"list-openapi.json DELETE /list/{list_name}/account/{account_id}","href":"/api-reference/lists/remove-account"}]},{"group":"Phone","pages":[{"title":"Phone Verification","openapi":"phone-openapi.json POST /phone","href":"/api-reference/phone/post"}]},{"group":"Email Intelligence API","hidden":false,"pages":[{"title":"Submit Email","openapi":"email-openapi.json POST /email","href":"/api-reference/email-intelligence/post"},{"title":"Submit Email Batch","openapi":"email-batch-openapi.json POST /email","href":"/api-reference/email-intelligence/post-batch"}]},{"group":"Face Match","pages":[{"title":"Verify Face","openapi":"facematch-openapi.json POST /liveness/verify-face","href":"/api-reference/face-match/verify-face"},{"title":"Verify Identity","openapi":"facematch-openapi.json POST /liveness/verify-identity","href":"/api-reference/face-match/verify-identity"},{"title":"Get Face Match Session","openapi":"facematch-openapi.json GET /liveness/session","href":"/api-reference/face-match/session"},{"title":"Public Redirect","openapi":"facematch-openapi.json GET /public/liveness-redirect","href":"/api-reference/face-match/public-redirect"}]},{"group":"ID Check","pages":[{"title":"Verify ID","openapi":"idcheck-openapi.json POST /liveness/verify-id","href":"/api-reference/id-check/verify-id"},{"title":"Get ID Check Session","openapi":"idcheck-openapi.json GET /liveness/session","href":"/api-reference/id-check/session"},{"title":"Public Redirect","openapi":"idcheck-openapi.json GET /public/liveness-redirect","href":"/api-reference/id-check/public-redirect"}]},{"group":"Types","pages":[{"title":"Account","href":"/api-reference/types/account"},{"title":"Email","href":"/api-reference/types/email"}]}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/examples/web-sample-app"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Authenticate Session - Verisoul","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BAvA99GL.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}