Skip to main content
POST
/
sdk
/
verify-token
Validate a verification token
curl --request POST \
  --url https://api.botshield.ai/operations/sdk/verify-token \
  --header 'Content-Type: application/json' \
  --data '
{
  "token": "<string>",
  "signal_token": "<string>"
}
'
{
  "valid": true,
  "reason": "<string>",
  "confidence": 0.5,
  "claims": {
    "request_id": "<string>",
    "verified": true,
    "botshield_user_id": "<string>",
    "organization_id": "<string>",
    "partner_user_id": "<string>",
    "user_email": "<string>",
    "timestamp": "<string>",
    "issued_at": 123,
    "expires_at": 123
  },
  "signals": {
    "botshield_score": 123,
    "turnstile": {
      "success": true
    },
    "passkey": {
      "verified": true
    }
  }
}

Body

application/json
token
string
required

JWT verification receipt

signal_token
string

Optional Signal Pixel token for combined confidence

Response

200 - application/json

Validation result

valid
boolean
reason
string
confidence
number

Combined confidence (passkey + signals + integrations)

Required range: 0 <= x <= 1
claims
object
signals
object