Skip to main content
Check if a wallet address belongs to a verified identity. Returns verification status and all associated wallets.
This endpoint requires your API key and must only be called from your backend server.

​
Request

cURL
curl -X POST "https://api.kyc.predicate.io/api/v1/verify" \
  -H "Authorization: Bearer $PREDICATE_KYC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "type": "individual"
  }'

​
Response (Verified)

{
  "address": "0x1234...",
  "verified": true,
  "userId": "uuid-of-verified-identity",
  "checkType": "kyc",
  "verifiedAt": "2025-01-21T10:30:00Z",
  "wallets": [
    { "address": "0x1234...", "chain": "ethereum" },
    { "address": "0x5678...", "chain": "polygon" }
  ]
}

​
Response (Not Verified)

{
  "address": "0x1234...",
  "verified": false,
  "userId": null,
  "checkType": null,
  "verifiedAt": null,
  "wallets": []
}

​
Endpoint

POST https://api.kyc.predicate.io/api/v1/verify

​
Request Body

​
address
string
required
The wallet address to check
​
type
string
Filter by verification type: individual (KYC) or business (KYB). Omit to check all types.

​
Response Fields

​
address
string
required
The wallet address that was checked
​
verified
boolean
required
Whether the wallet belongs to a verified identity
​
userId
string
The user ID of the verified identity (null if not verified)
​
checkType
string
The verification type: kyc or kyb (null if not verified)
​
verifiedAt
string
ISO 8601 timestamp of when verification completed (null if not verified)
​
wallets
array
All wallet addresses belonging to this verified identity (empty if not verified)

​
Authentication

Authorization: Bearer YOUR_API_KEY