Skip to main content
cURL
curl --request POST \
  --url https://api.sandbox.verisoul.ai/session/authenticate \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "account": {
    "id": "<string>",
    "email": "<string>",
    "metadata": {},
    "group": "<string>",
    "lists": [
      "<string>"
    ]
  },
  "session_id": "<string>"
}
'
{ "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": { "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&T Internet", "connection_type": "isp" }, "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 }, "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 }, "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 } }, "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 } } }

Documentation Index

Fetch the complete documentation index at: https://docs.verisoul.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
accounts_linked
boolean

Whether to include linked accounts in the response

Body

application/json

Session authentication information

​
account
object
required

The account to authenticate. See Account Object for more information.

​
session_id
string
required

The ID of the session to authenticate

Response

Session authentication response

​
project_id
string

The ID of the project

​
session_id
string

The ID of the session

​
account_id
string

The ID of the account

​
request_id
string

The ID of the request

​
decision
string

Decision about the authenticity (Real/Fake)

​
account_score
number<float>

Overall account risk score

​
bot
number<float>

Bot detection score

​
multiple_accounts
number<float>

Multiple accounts detection score

​
risk_signals
number<float>

Risk signals score

​
accounts_linked
integer

Number of accounts linked to this account

​
lists
string[]

Lists the account belongs to

​
session
object
​
account
object
​
linked_accounts
object[]

List of accounts linked to the authenticated account (only included when accounts_linked=true)