API Documentation
Account
Lists
Types
Authenticate Session
Authenticates a session with an account
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": {}
},
"session_id": "<string>"
}'
{
"project_id": "<string>",
"session_id": "<string>",
"account_id": "<string>",
"request_id": "<string>",
"decision": "<string>",
"account_score": 123,
"bot": 123,
"multiple_accounts": 123,
"risk_signals": 123,
"accounts_linked": 123,
"lists": [
"<string>"
],
"session": {
"start_time": "2023-11-07T05:31:56Z",
"true_country_code": "<string>",
"network": {
"ip_address": "<string>",
"service_provider": "<string>",
"connection_type": "<string>"
},
"location": {
"continent": "<string>",
"country_code": "<string>",
"state": "<string>",
"city": "<string>",
"zip_code": "<string>",
"timezone": "<string>",
"latitude": 123,
"longitude": 123
},
"browser": {
"type": "<string>",
"version": "<string>",
"language": "<string>",
"user_agent": "<string>",
"timezone": "<string>"
},
"device": {
"category": "<string>",
"type": "<string>",
"os": "<string>",
"cpu_cores": 123,
"memory": 123,
"gpu": "<string>"
},
"bot": {
"mouse_num_events": 123,
"click_num_events": 123,
"keyboard_num_events": 123,
"touch_num_events": 123,
"clipboard_num_events": 123
},
"risk_signals": {
"device_risk": true,
"proxy": true,
"vpn": true,
"tor": true,
"spoofed_ip": true,
"datacenter": true,
"recent_fraud_ip": true,
"impossible_travel": true,
"device_network_mismatch": true
},
"risk_signal_scores": {
"device_risk": 123,
"proxy": 123,
"vpn": 123,
"tor": 123,
"datacenter": 123,
"recent_fraud_ip": 123,
"impossible_travel": 123,
"device_network_mismatch": 123
}
},
"account": {
"account": {
"id": "<string>",
"email": "<string>",
"metadata": {}
},
"num_sessions": 123,
"first_seen": "2023-11-07T05:31:56Z",
"last_seen": "2023-11-07T05:31:56Z",
"last_session": "<string>",
"country": "<string>",
"countries": [
"<string>"
],
"unique_devices": {
"1_day": 123,
"7_day": 123
},
"unique_networks": {
"1_day": 123,
"7_day": 123
},
"email": {
"email": "<string>",
"disposable": true,
"personal": true,
"valid": true
},
"risk_signal_average": {
"device_risk": 123,
"proxy": 123,
"vpn": 123,
"tor": 123,
"spoofed_ip": 123,
"datacenter": 123,
"recent_fraud_ip": 123,
"impossible_travel": 123,
"device_network_mismatch": 123
}
},
"linked_accounts": [
{
"account_id": "<string>",
"score": 123,
"email": "<string>",
"match_type": [
"<string>"
],
"lists": [
"<string>"
],
"metadata": {}
}
]
}
Authorizations
Query Parameters
Whether to include linked accounts in the response
Body
The account to authenticate. See Account Object for more information.
The ID of the session to authenticate
Response
The ID of the project
The ID of the session
The ID of the account
The ID of the request
Decision about the authenticity (Real/Fake)
Overall account risk score
Bot detection score
Multiple accounts detection score
Risk signals score
Number of accounts linked to this account
Lists the account belongs to
Timestamp when the session started
The true country code of the session
Continent code
Country code
State or region
City name
Postal/ZIP code
Timezone of the location
Latitude coordinate
Longitude coordinate
Device category (desktop, mobile, etc.)
Device type
Operating system
Number of CPU cores
Amount of memory in GB
GPU information
Number of mouse events
Number of click events
Number of keyboard events
Number of touch events
Number of clipboard events
Device risk flag
Proxy usage flag
VPN usage flag
Tor usage flag
Spoofed IP flag
Datacenter IP flag
Recent fraud IP flag
Impossible travel flag
Device network mismatch flag
Device risk score
Proxy detection score
VPN detection score
Tor detection score
Datacenter detection score
Recent fraud IP detection score
Impossible travel detection score
Device network mismatch score
Number of sessions associated with this account
Timestamp when the account was first seen
Timestamp when the account was last seen
ID of the last session
Country code of the account
List of countries associated with this account
Device risk score
Proxy detection score
VPN detection score
Tor detection score
Spoofed IP detection score
Datacenter detection score
Recent fraud IP detection score
Impossible travel detection score
Device network mismatch score
List of accounts linked to the authenticated account (only included when accounts_linked=true)
The ID of the linked account
Confidence score of the link between accounts
Email associated with the linked account
Types of matches that linked these accounts
Lists the linked account belongs to
Additional metadata about the linked account
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": {}
},
"session_id": "<string>"
}'
{
"project_id": "<string>",
"session_id": "<string>",
"account_id": "<string>",
"request_id": "<string>",
"decision": "<string>",
"account_score": 123,
"bot": 123,
"multiple_accounts": 123,
"risk_signals": 123,
"accounts_linked": 123,
"lists": [
"<string>"
],
"session": {
"start_time": "2023-11-07T05:31:56Z",
"true_country_code": "<string>",
"network": {
"ip_address": "<string>",
"service_provider": "<string>",
"connection_type": "<string>"
},
"location": {
"continent": "<string>",
"country_code": "<string>",
"state": "<string>",
"city": "<string>",
"zip_code": "<string>",
"timezone": "<string>",
"latitude": 123,
"longitude": 123
},
"browser": {
"type": "<string>",
"version": "<string>",
"language": "<string>",
"user_agent": "<string>",
"timezone": "<string>"
},
"device": {
"category": "<string>",
"type": "<string>",
"os": "<string>",
"cpu_cores": 123,
"memory": 123,
"gpu": "<string>"
},
"bot": {
"mouse_num_events": 123,
"click_num_events": 123,
"keyboard_num_events": 123,
"touch_num_events": 123,
"clipboard_num_events": 123
},
"risk_signals": {
"device_risk": true,
"proxy": true,
"vpn": true,
"tor": true,
"spoofed_ip": true,
"datacenter": true,
"recent_fraud_ip": true,
"impossible_travel": true,
"device_network_mismatch": true
},
"risk_signal_scores": {
"device_risk": 123,
"proxy": 123,
"vpn": 123,
"tor": 123,
"datacenter": 123,
"recent_fraud_ip": 123,
"impossible_travel": 123,
"device_network_mismatch": 123
}
},
"account": {
"account": {
"id": "<string>",
"email": "<string>",
"metadata": {}
},
"num_sessions": 123,
"first_seen": "2023-11-07T05:31:56Z",
"last_seen": "2023-11-07T05:31:56Z",
"last_session": "<string>",
"country": "<string>",
"countries": [
"<string>"
],
"unique_devices": {
"1_day": 123,
"7_day": 123
},
"unique_networks": {
"1_day": 123,
"7_day": 123
},
"email": {
"email": "<string>",
"disposable": true,
"personal": true,
"valid": true
},
"risk_signal_average": {
"device_risk": 123,
"proxy": 123,
"vpn": 123,
"tor": 123,
"spoofed_ip": 123,
"datacenter": 123,
"recent_fraud_ip": 123,
"impossible_travel": 123,
"device_network_mismatch": 123
}
},
"linked_accounts": [
{
"account_id": "<string>",
"score": 123,
"email": "<string>",
"match_type": [
"<string>"
],
"lists": [
"<string>"
],
"metadata": {}
}
]
}