DD & KYC Verification
This API is used to check the lead’s compliance by validating opt-in data (like consent source and timestamp), and verifies identity using name, phone number, and address against external data sources.
Sandbox
You are viewing Sandbox mode docs.
Switch using the toggle on the dashboard.
You don't have a sandbox API key yet. Generate one in Settings → API Keys.
The examples below use a placeholder so you can still read the request shape.
cURL Request (Multiple leads verification)
curl -X POST "https://eloquent-shirley.77-68-26-98.plesk.page/api/sandbox/v1/tds_verify" \
-H "Authorization: Bearer YOUR_SANDBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"dd_check": {
"dd_code": "abc123",
"phone_numbers": ["07123456789", "07198765432"]
},
"kyc_check": {
"first_name": "John",
"last_name": "Doe",
"dob": "1985-06-15",
"email": "john.doe@example.com",
"phone": "07123456789",
"address": {
"line_1": "123 High Street",
"line_2": "Flat 5",
"city": "London",
"postcode": "W1A 1AA"
}
},
"check_type": "Both"
}'
Response
200
403
500
{
"status": "success",
"dd_result": {
"verified": true,
"system_message": "Successfully verified",
"opt_in_source": "Website",
"opt_in_timestamp": "2024-06-10T14:30:00Z",
"referrer_url": "https://example.com",
"ip_address": "192.168.1.1",
"user_agent": "Mozilla/5.0",
"consent_method": "Web Form",
"phone_opt_in": true,
"email_opt_in": false
},
"kyc_result": {
"status": "verified",
"matches": {
"name_match": true,
"dob_match": true,
"address_match": true
},
"risk_score": 3,
"flags": ["no_sanctions", "not_pep"]
}
}