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