LogoLogo
Useful links
  • Home
  • Product guides
  • API
  • SDKs
  • Overview
  • CORE API
    • Authentication
    • Available resources
      • Transaction
      • Onboarding
      • Profile
      • Synchronous services
        • OCR Sync
        • Basic Data Sync (Individual)
    • Transaction details
      • Services
        • Document OCR
        • Documentscopy
        • Face Liveness
        • Facematch
        • Facial Biometrics
        • Private Faceset
        • Shared Faceset
        • Document Liveness
      • Background check
        • Data structure
        • KYC
          • Driver
          • Financial
          • Labor
          • Register data
          • Relationships
          • Risk
        • KYB
          • Financial
          • Labor
          • Register data
          • Risk
        • Vehicle
          • Register data
      • Validation rules
      • Manual reprovals
    • Webhooks
      • Transaction
      • Profile
      • Face authentication
  • MOBILE API
    • Authentication
    • Available resources
      • Face liveness (deprecated)
      • Face registration (deprecated)
      • Face authentication (deprecated)
    • Response signature
  • GLOBAL API
    • Authentication
    • Available resources
      • Services
        • Company search
        • Company record
        • Basic Data Sync (Individual)
        • Sanctions
      • Orchestrations
        • Transactions
          • Services
            • KYB
              • Credit Report
              • Business Identity
            • KYC
              • Adverse Media
              • PEPs
              • Sanctions
              • Warnings
              • Global identity verification
              • Global identity double verification
            • DOC ID
              • Global Document Verification
      • Onboardings
        • Links
    • Webhooks
  • SMART AUTH API
    • Authentication
    • Available resources
      • Authentications
      • Create identity
  • Joint resolution 6 API
    • Authentication
    • Available resources
      • Suspected fraud creation
      • Suspected fraud query
      • Suspected fraud update
      • Suspected fraud deletion
    • Using mTLS
    • Changelog
LogoLogo

2025 © Caf. - All rights reserved

On this page
  1. GLOBAL API
  2. Available resources
  3. Orchestrations
  4. Transactions
  5. Services
  6. KYC

Global identity verification

Last updated 2 months ago

The query functions to verify if a person's basic data is consistent. In other words, it assesses whether the name, date of birth, address, phone number, and document number indeed belong to that person. Through this verification, the query validates the provided set of data and classifies the reliability of the information as reliable, sufficient, or unreliable.

To indicate an individual's trustworthiness, there are several possible combinations of data to evaluate the reliability score, which can vary between 10, 20, or 30.

Section: globalIdentityVerifications

Supported Countries: Argentina, Australia*, Austria, Belgium, Brazil, Canada*, China, Chile, Colombia, Czechia, Denmark, Finland, France, Germany, Ghana, Gibraltar, Greece, Hong Kong*, India*, Indonesia, Ireland, Italy, Japan, Kenya, Luxembourg, Malaysia, Mexico, Netherlands, New Zealand, Nigeria, Norway, Philippines, Poland, Portugal, Singapore, Slovakia, South Africa, Spain, Sweden, Switzerland, Turkey, United Kingdom, United States and Vietnam.

Note: Australia, Canada, Hong Kong, and India require authorization for consultation before being able to access the data (Onboarding process).

Attribute
Type
Description
Mandatory

name

string

Full name of the individual.

Yes

birthDate

string

Date of birth of the individual.

Yes

address

string

Address of the individual.

Yes

phoneNumber

string

Phone number of the individual.

Yes

nationalId

string

A government-issued identification number or document.

Yes/No (Depends on the country)

zipCode

string

Zip code of the individual's address.

Yes

countryCode

string

Country code of the individual.

Yes

dateFormat

string

Date format of Birth Date.

No

body: JSON.stringify({
  workflowId: "6644843a90k8762k25929376",
  parameters: {
    name: "Mariana Oliveira",
    birthDate: "23/04/1995",
    phoneNumber: "+5551998765432",
    address: "Rua das Flores, 123",
    zipCode: "12345678",
    nationalId: "9876543210",
    countryCode: "BR",
    dateFormat: "dd/MM/yyyy",
  },
});

Note: Some fields returned by this API are optional and their presence cannot be guaranteed.

Attribute
Type
Description

data

object

Object containing the main data.

data.detailList

string

Details related to the query.

data.adaptation

string

Indicator of adaptation.

data.messages

array

List of messages providing details on the level of matches for each piece of data.

data.messages[].value

string

Indicates the match level of the data (Full match, No match, Partial match, etc.).

data.messages[].code

string

Code indicating the type of data analyzed (FIRSTNAME, COMPLETENAME, PHONENUMBER, etc.).

data.detailCode

string

Detailed code specific to the process or request.

data.query

object

Information about the performed query.

data.query.options

string

Internal value indicating the search type of the query.

data.reliability

string

Indicator of reliability (10, 20, 30).

data.statusCode

string

Transaction status. Check our status guide.

statusCode

string

{
  "data": {
    "detailList": "",
    "adaptation": "0",
    "messages": [
      {
        "value": "Full match was made on Complete Name",
        "code": "1MT-BR-GVT2-COMPLETENAME"
      },
      {
        "value": "Full match was made on First Initial",
        "code": "1MT-BR-GVT2-FIRSTINITIAL"
      },
      {
        "value": "Full match was made on First Name/Given Name",
        "code": "1MT-BR-GVT2-FIRSTNAME"
      },
      {
        "value": "Full match was made on Last Name/Surname ",
        "code": "1MT-BR-GVT2-LASTNAME"
      },
      {
        "value": "Full match was made on Postal Code/Zip Code",
        "code": "1MT-BR-GVT2-POSTALCODE"
      },
      {
        "value": "Full match was made on State/Province",
        "code": "1MT-BR-GVT2-PROVINCE"
      },
      {
        "value": "Datasource does not contain element Sub Premise Descriptors provided in Address Lines",
        "code": "4MT-BR-GVT2-SUBPREMISE"
      },
      {
        "value": "Datasource does not contain element Phone Number",
        "code": "4MT-BR-GVT2-PHONENUMBER"
      },
      {
        "value": "Partial match made on element Address Lines",
        "code": "3MT-BR-GVT2-ADDRESS"
      },
      {
        "value": "Full match was made on Date of Birth",
        "code": "1MT-BR-GVT2-DATEOFBIRTH"
      },
      {
        "value": "Full match was made on Day of Birth",
        "code": "1MT-BR-GVT2-DAYOFBIRTH"
      },
      {
        "value": "Full match was made on Month of Birth",
        "code": "1MT-BR-GVT2-MONTHOFBIRTH"
      },
      {
        "value": "Full match was made on Year of Birth",
        "code": "1MT-BR-GVT2-YEAROFBIRTH"
      },
      {
        "value": "Full match was made on Last Name/Surname",
        "code": "1AU-400-LASTNAME"
      },
      {
        "value": "Full match was made on First Name/Given Name",
        "code": "1AU-350-FIRSTNAME"
      },
      {
        "value": "Full match was made on First Initial",
        "code": "1AU-375-FIRSTINITIAL"
      },
      {
        "value": "Full match was made on Complete Name",
        "code": "1AU-425-COMPLETENAME"
      },
      {
        "value": "Full match was made on Year of Birth",
        "code": "1AU-625-YEAROFBIRTH"
      },
      {
        "value": "Full match was made on Month of Birth",
        "code": "1AU-600-MONTHOFBIRTH"
      },
      {
        "value": "Full match was made on Day of Birth",
        "code": "1AU-575-DAYOFBIRTH"
      },
      {
        "value": "Full match was made on Date of Birth",
        "code": "1AU-550-DATEOFBIRTH"
      },
      {
        "value": "Partial match made on element Address Lines",
        "code": "3AU-200-ADDRESS"
      },
      {
        "value": "No match was made on Street/Thoroughfare",
        "code": "2AU-075-THOROUGHFARE"
      },
      {
        "value": "No match was made on House Number/Street Number",
        "code": "2AU-050-HOUSENUMBER"
      },
      {
        "value": "No match was made on District",
        "code": "2AU-225-DISTRICT"
      },
      {
        "value": "Full match was made on State/Province",
        "code": "1AU-325-PROVINCE"
      },
      {
        "value": "Full match was made on Postal Code/Zip Code",
        "code": "1AU-275-POSTALCODE"
      },
      {
        "value": "Full Match for 1+1 verification",
        "code": "1MT-BR-MATCHED-1+1"
      },
      {
        "value": "1AU-275-POSTALCODE;1AU-325-PROVINCE;1AU-350-FIRSTNAME;1AU-375-FIRSTINITIAL;1AU-400-LASTNAME;1AU-425-COMPLETENAME;1AU-550-DATEOFBIRTH;1AU-575-DAYOFBIRTH;1AU-600-MONTHOFBIRTH;1AU-625-YEAROFBIRTH;1MT-BR-GVT2-COMPLETENAME;1MT-BR-GVT2-DATEOFBIRTH;1MT-BR-GVT2-DAYOFBIRTH;1MT-BR-GVT2-FIRSTINITIAL;1MT-BR-GVT2-FIRSTNAME;1MT-BR-GVT2-LASTNAME;1MT-BR-GVT2-MONTHOFBIRTH;1MT-BR-GVT2-POSTALCODE;1MT-BR-GVT2-PROVINCE;1MT-BR-GVT2-YEAROFBIRTH;1MT-BR-MATCHED-1+1;2AU-050-HOUSENUMBER;2AU-075-THOROUGHFARE;2AU-225-DISTRICT;3AU-200-ADDRESS;3MT-BR-GVT2-ADDRESS;4MT-BR-GVT2-PHONENUMBER;4MT-BR-GVT2-SUBPREMISE;",
        "code": "Codes"
      }
    ],
    "detailCode": "WS-2253205.2024.4.27.17.1.51.23",
    "query": {
      "options": "identityverify;messageverbose"
    },
    "reliability": "10"
  }
}
Rule
Description

Basic information with reliable match

Indicates whether the individual's basic information (name, address, dob, document number and phone number) matches.

Basic information with sufficient match

Indicates whether the individual's basic information (name, address, dob, document number and phone number) partially matches.

References the status of this query only, not the entire transaction.

Check our status guide