cURL
curl --request PUT \
  --url https://api.sandbox.verisoul.ai/account/{account_id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "id": "<string>",
  "email": "<string>",
  "metadata": {}
}'
{
  "project_id": "00000000-0000-0000-0000-000000000001",
  "request_id": "e23cf3bd-7d33-440e-af9f-6d1d3182e2f9",
  "account": {
    "id": "john-doe",
    "email": "johndoe.example@gmail.com",
    "metadata": {},
    "group": ""
  },
  "num_sessions": 1,
  "first_seen": "2025-06-10T16:47:29.661079410Z",
  "last_seen": "2025-06-10T16:47:29.661079410Z",
  "last_session": "56f9a065-1583-48af-a5c4-cd5921b21a12",
  "country": "US",
  "countries": [
    "US"
  ],
  "decision": "Real",
  "account_score": 0.9392,
  "bot": 0,
  "multiple_accounts": 0.2053,
  "risk_signals": 1,
  "accounts_linked": 2,
  "lists": [
    "us_users"
  ],
  "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"
    ]
  },
  "risk_signal_average": {
    "device_risk": 0.3971,
    "proxy": 0,
    "vpn": 0,
    "tor": 0,
    "spoofed_ip": 0,
    "datacenter": 0,
    "recent_fraud_ip": 0,
    "impossible_travel": 0,
    "device_network_mismatch": 0.0001
  }
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
account_id
string
required

ID of the account to update

Body

application/json

Account information to update

​
id
string
required

The account identifier

​
email
string

The email associated with the account

​
metadata
object

Additional metadata about the account

Response

Updated account information

​
project_id
string

The ID of the project

​
request_id
string

The ID of the request

​
account
object
​
num_sessions
integer

Number of sessions associated with this account

​
first_seen
string<date-time>

Timestamp when the account was first seen

​
last_seen
string<date-time>

Timestamp when the account was last seen

​
last_session
string

ID of the last session

​
decision
string

Decision about the account authenticity

​
account_score
number

Overall account risk score

​
bot
number

Bot detection score

​
multiple_accounts
number

Multiple accounts detection score

​
risk_signals
number

Risk signals score

​
accounts_linked
integer

Number of accounts linked to this account

​
country
string

Country code of the account

​
lists
string[]

Lists the account belongs to

​
unique_devices
object
​
unique_networks
object
​
email
object
​
risk_signal_average
object