DoTrust's Identity check is multi-source KYC suitable for opening a customer account. You provide the customer's name, date of birth and address, and we confirm their identity against independent data sources.

Including your own customer_id on the request is optional for identity checks. If you don't send one, use the dot_uuid we return to map the result to the customer_id you assign after registration.

INFO

This page documents the v3 identity endpoint (POST /identity on https://api.dotrust.co/api/v3). The v2 identity endpoint is deprecated — switch to v3 by updating the path. See the API tab for the full request and response schema.

How the check works

A customer passes when two or more independent sources confirm their name, address and date of birth. v3 also resolves and, where needed, auto-corrects the supplied address, and surfaces the individual data sources that corroborated the identity so you can apply your own risk rules.

Response structure

interface IdentityCheckResponse {
  request_id: string;
  timestamp: string;
  customer_id: string;
  inquiry: 'identity';
  data: IdentityCheckData;
}

interface IdentityCheckData {
  pass: boolean;
  firstName: string;
  surname: string;
  dob: string;
  addressProvided: string;
  correctAddress: string;
  addressValid: boolean;
  electoralRoll: 0 | 1 | 2;
  courtRecords: 0 | 1 | 2;
  financialAgreements: 0 | 1 | 2;
  creditSearches: 0 | 1 | 2;
  companiesHouse: 0 | 1 | 2;
  addressNotCurrent: boolean;
  mortality: boolean;
  dot_uuid: string;
}

Interpreting the result

Field	Meaning
pass	true when two or more independent sources confirm name, address and date of birth.
firstName, surname, dob, addressProvided	The details that were checked, echoed back from your request.
correctAddress	When the pass is achieved on a close match to the provided address, this contains the corrected address (for example, a different flat number). Empty when no correction was needed.
addressValid	true if the address resolves to a known residential UK letterbox. This is necessary for fully legal matching against CRA and other regulated sources. false means the address could not be resolved at all.
addressNotCurrent	true if we found data indicating the person may have moved from this address, or has a concurrent additional address. May require further investigation.
mortality	true if the person is listed as deceased in at least one official data source.
dot_uuid	DoTrust's internal identifier for this person, unique to them on our platform. Quote it in support enquiries. If you did not supply a customer_id on the request, use it to map to the customer_id you assign after registration.

Source corroboration counts

electoralRoll, courtRecords, financialAgreements, creditSearches and companiesHouse each give the number of independent sources corroborating name, address and DOB in combination (min 0, max 2). They let you see how an identity was confirmed and build your own confidence thresholds on top of the overall pass.

INFO

The number of independent sources needed for a pass is fixed at two or more. The individual counts are provided for transparency and to support your own risk methodology.