Skip to main content
POST
/
v3
/
database-validation
Database Validation
curl --request POST \
  --url https://verification.didit.me/v3/database-validation/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "issuing_state": "ARG",
  "validation_type": "one_by_one",
  "identification_number": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "date_of_birth": "<string>",
  "document_type": "P",
  "expiration_date": "2023-12-25",
  "nationality": "<string>",
  "address": "<string>",
  "save_api_request": true,
  "vendor_data": "<string>"
}
'
{
  "request_id": "929fd984-40b7-4281-90fb-ecbc8377fe25",
  "database_validation": {
    "status": "Approved",
    "issuing_state": "BRA",
    "validation_type": "one_by_one",
    "screened_data": {
      "tax_number": "00000000191",
      "first_name": "Jane",
      "last_name": "Doe",
      "date_of_birth": "1990-01-15"
    },
    "match_type": "full_match",
    "validations": [
      {
        "validation": {
          "full_name": "full_match",
          "date_of_birth": "full_match",
          "identification_number": "full_match"
        },
        "source_data": {
          "identification_number": "00000000191",
          "first_name": "JANE",
          "last_name": "DOE",
          "date_of_birth": "1990-01-15"
        }
      }
    ],
    "warnings": []
  },
  "created_at": "2025-01-01T00:00:00+00:00"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
issuing_state
enum<string>
required

The ISO 3166-1 alpha-3 country code of the issuing state. Determines which validation sources are used.

Available options:
ARG,
BOL,
BRA,
CHL,
COL,
CRI,
DOM,
ECU,
ESP,
GTM,
HND,
MEX,
PAN,
PER,
PRY,
SLV,
URY,
VEN
​
validation_type
enum<string>
default:one_by_one
required

The type of matching to perform: '1x1' for single-database matching or '2x2' for dual-database matching.

Available options:
one_by_one,
two_by_two
​
identification_number
string
required

Universal identification number field. Automatically maps to the correct country-specific field: ARG→document_number (DNI), BOL→document_number (CI), BRA→tax_number (CPF, 11 digits), CHL→personal_number (RUT), COL→personal_number (Cédula), CRI→personal_number (Cédula), DOM→personal_number (Cédula, 11 digits), ECU→personal_number (Cédula, 10 digits), ESP→personal_number (DNI/NIE), GTM→document_number (DPI), HND→document_number (DNI), MEX→personal_number (CURP, 18 chars), PAN→document_number (Cédula), PER→personal_number (DNI, 8 digits), PRY→document_number (CI), SLV→document_number (DUI), URY→personal_number (CI), VEN→document_number (Cédula).

​
first_name
string

The individual's first name. Might be required for some countries and matching types.

​
last_name
string

The individual's last name. Might be required for some countries and matching types.

​
date_of_birth
string

The individual's date of birth in YYYY-m-d format. Might be required for some countries and matching types. Example: 1990-01-01.

​
document_type
enum<string>

The type of document being validated. P = Passport, DL = Driver License, ID = National ID, RP = Residence Permit. Optional field that may help with validation in some countries.

Available options:
P,
DL,
ID,
RP
​
expiration_date
string<date>

The document's expiration date in YYYY-MM-DD format. Required for ESP (Spain) database validation. Example: 2030-01-15.

​
nationality
string

The individual's nationality, expressed as an ISO 3166-1 alpha-3 country code. Might be required for some countries and matching types.

​
address
string

The individual's residential address. Used in specific jurisdictions where address validation is supported. Might be required for some countries and matching types.

​
save_api_request
boolean
default:true

Whether to save this API request. If true, then it will appear on the Manual Checks section in the Business Console.

​
vendor_data
string

A unique identifier for the vendor or user, such as a UUID or email. This field enables proper session tracking and user data aggregation across multiple verification sessions.

Response