curl -X POST \
"https://verilock.io/api/v1/database/validate" \
-H "Authorization: Bearer qi_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"provider": "mock",
"session_id": "ses_a1b2c3d4-...",
"first_name": "Jean",
"last_name": "Dupont",
"date_of_birth": "1985-06-12",
"country": "FR"
}'
import requests
response = requests.post(
"https://verilock.io/api/v1/database/validate",
headers={
"Authorization": "Bearer qi_live_your_api_key_here",
"Content-Type": "application/json",
},
json={
"provider": "mock",
"first_name": "Jean",
"last_name": "Dupont",
"date_of_birth": "1985-06-12",
"country": "FR",
},
)
const res = await fetch('https://verilock.io/api/v1/database/validate', {
method: 'POST',
headers: {
'Authorization': 'Bearer qi_live_your_api_key_here',
'Content-Type': 'application/json',
},
body: JSON.stringify({
provider: 'mock',
first_name: 'Jean',
last_name: 'Dupont',
date_of_birth: '1985-06-12',
country: 'FR',
}),
});
{
"providers": [
{
"name": "mock",
"countries": ["*"]
}
]
}
Data & Compliance
Database Validation
Validate identity data against government and third-party databases.
POST
/
database
/
validate
curl -X POST \
"https://verilock.io/api/v1/database/validate" \
-H "Authorization: Bearer qi_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"provider": "mock",
"session_id": "ses_a1b2c3d4-...",
"first_name": "Jean",
"last_name": "Dupont",
"date_of_birth": "1985-06-12",
"country": "FR"
}'
import requests
response = requests.post(
"https://verilock.io/api/v1/database/validate",
headers={
"Authorization": "Bearer qi_live_your_api_key_here",
"Content-Type": "application/json",
},
json={
"provider": "mock",
"first_name": "Jean",
"last_name": "Dupont",
"date_of_birth": "1985-06-12",
"country": "FR",
},
)
const res = await fetch('https://verilock.io/api/v1/database/validate', {
method: 'POST',
headers: {
'Authorization': 'Bearer qi_live_your_api_key_here',
'Content-Type': 'application/json',
},
body: JSON.stringify({
provider: 'mock',
first_name: 'Jean',
last_name: 'Dupont',
date_of_birth: '1985-06-12',
country: 'FR',
}),
});
{
"providers": [
{
"name": "mock",
"countries": ["*"]
}
]
}
Cross-reference extracted identity data (name, date of birth, document number) against government registries and third-party data sources.
Returns available validation providers for your organization.
Retrieve the result of a previous validation.
List Providers
GET /v1/database/providers
{
"providers": [
{
"name": "mock",
"countries": ["*"]
}
]
}
The
mock provider is available in sandbox mode for testing. Contact us to enable production providers for specific countries.Validate Identity
string
required
Provider name (from
/database/providers).string
Link this validation to a verification session. Optional.
string
required
First name as it appears on the official document.
string
required
Last name as it appears on the official document.
string
Date of birth in
YYYY-MM-DD format.string
Government-issued document number.
string
ISO 3166-1 alpha-2 country code.
curl -X POST \
"https://verilock.io/api/v1/database/validate" \
-H "Authorization: Bearer qi_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"provider": "mock",
"session_id": "ses_a1b2c3d4-...",
"first_name": "Jean",
"last_name": "Dupont",
"date_of_birth": "1985-06-12",
"country": "FR"
}'
import requests
response = requests.post(
"https://verilock.io/api/v1/database/validate",
headers={
"Authorization": "Bearer qi_live_your_api_key_here",
"Content-Type": "application/json",
},
json={
"provider": "mock",
"first_name": "Jean",
"last_name": "Dupont",
"date_of_birth": "1985-06-12",
"country": "FR",
},
)
const res = await fetch('https://verilock.io/api/v1/database/validate', {
method: 'POST',
headers: {
'Authorization': 'Bearer qi_live_your_api_key_here',
'Content-Type': 'application/json',
},
body: JSON.stringify({
provider: 'mock',
first_name: 'Jean',
last_name: 'Dupont',
date_of_birth: '1985-06-12',
country: 'FR',
}),
});
{
"id": "dbv_c3d4e5f6-a1b2-7890-fedc-ba0987654321",
"status": "completed",
"match_score": 92.50,
"field_matches": {
"first_name": true,
"last_name": true,
"date_of_birth": true,
"address": false
},
"result_data": {
"first_name": "Jean",
"last_name": "Dupont",
"date_of_birth": "1985-06-12",
"address": "15 Rue de la Paix, Paris",
"document_number": "MOCK-A3F2B1C8",
"source": "mock_government_database"
}
}
Get Validation Result
GET /v1/database/validate/{id}
Status Values
| Status | Description |
|---|---|
completed | Validation successful, data returned |
not_found | No matching record found |
error | Provider returned an error |
pending | Validation is still processing |