Verify a Shield session
verify_sessionRun a server-side risk check on a FindIP Shield session before signup, login, or checkout; returns risk score, action recommendation, challenge status, and network/rotation flags.
Instructions
Server-side risk check for one FindIP Shield session: risk score, recommendation (allow, monitor, challenge, block), whether a challenge was passed, and the session picture (IP, ASN and country rotation, network flags, risk reasons). This is the same check a backend runs before acting on a signup, login or checkout. An unknown session returns verified: false; a session without IP intelligence returns risk_status "unknown", which is not the same as safe. Uses the site secret key from FINDIP_SHIELD_SECRET_KEY.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"session_id": "<session_id>"
},
"name": "verify_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| event | No | Optional event the check is for, for example signup_attempt | |
| session_id | Yes | Shield session ID sent by the browser SDK (FindIP.getSession().sessionId) |