> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/core-api/transaction-details/background-check/kyc/gdc.md). # Global identity verification 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. ![](/files/6HoQRdgfr5E0WQ7I2p84) **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). {% tabs %} {% tab title="Parameters" %} | 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 | | {% endtab %} | | | | {% tab title="Example body" %} ```javascript 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", }, }); ``` {% endtab %} {% endtabs %} **Note:** Some fields returned by this API are optional and their presence cannot be guaranteed. {% tabs %} {% tab title="Schema" %} | 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 | References the status of this query only, not the entire transaction. [Check our status guide](/caf-api/core-api/transaction-details/background-check.md) | | {% endtab %} | | | {% tab title="Example" %} ```json { "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" } } ``` {% endtab %} {% tab title="Validations Rules" %} | 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. | | {% endtab %} | | | {% endtabs %} | | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.caf.io/caf-api/core-api/transaction-details/background-check/kyc/gdc.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.