Skip to main content
Our Database Validation process cross-references the user’s information against trusted, authoritative sources to confirm their identity. This verification is a key step in ensuring compliance and mitigating the risk of identity fraud. Below is a detailed explanation of the fields you can expect in a Database Validation Report.

​
Report Structure

The validation report is returned as a JSON object containing a database_validation object with the following key sections:
  • status: The overall outcome of the validation check (Approved, Declined, or In Review).
  • match_type: The overall match result, indicating the level of confidence in the user’s identity (full_match, partial_match, or no_match).
  • issuing_state: The country where the validation was performed, represented by its three-letter ISO code.
  • validation_type: The specific method used for validation, such as 1x1 or 2x2 matching.
  • screened_data: The user-provided data that was used for the validation check.
  • validations: An object containing the detailed results from each checked data point.

​
Core Response Fields

interface DatabaseValidationReport {
  database_validation: {
    status: "Approved" | "Declined" | "In Review";
    match_type: "full_match" | "partial_match" | "no_match";
    issuing_state: string;
    validation_type: "1x1" | "2x2";
    screened_data: {
      tax_number?: string;
      personal_number?: string;
      first_name: string;
      last_name: string;
      date_of_birth?: string;
    };
    validations: {
      full_name?: "full_match" | "partial_match" | "no_match";
      date_of_birth?: "full_match" | "partial_match" | "no_match";
      identification_number?: "full_match" | "partial_match" | "no_match";
    };
  };
}

​
Sample JSON Response

{
  "database_validation": {
    "status": "Approved",
    "match_type": "full_match",
    "issuing_state": "BRA",
    "validation_type": "1x1",
    "screened_data": {
      "tax_number": "00147177278",
      "first_name": "ANTONIO RAIMUNDO",
      "last_name": "GUIMARAES DE LIMA",
      "date_of_birth": "1988-03-18"
    },
    "validations": {
      "full_name": "full_match",
      "date_of_birth": "full_match",
      "identification_number": "full_match"
    }
  }
}
For more information about potential warnings during the Databse Validation process, check our Database Validation Warnings guide.