Skip to main content
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.

​
List Providers

GET /v1/database/providers
Returns available validation providers for your organization. 
{
  "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

​
provider
string
required
Provider name (from /database/providers).
​
session_id
string
Link this validation to a verification session. Optional.
​
first_name
string
required
First name as it appears on the official document.
​
last_name
string
required
Last name as it appears on the official document.
​
date_of_birth
string
Date of birth in YYYY-MM-DD format.
​
document_number
string
Government-issued document number.
​
country
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}
Retrieve the result of a previous validation.

​
Status Values

StatusDescription
completedValidation successful, data returned
not_foundNo matching record found
errorProvider returned an error
pendingValidation is still processing