> 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/caf-api-pt-br/api-core/transaction-details/background-check/kyc/gdc.md). # Verificação global de identidade A função da consulta é verificar se os dados básicos de uma pessoa são consistentes. Em outras palavras, ela avalia se o nome, a data de nascimento, o endereço, o número de telefone e o número do documento realmente pertencem a essa pessoa. Por meio dessa verificação, a consulta valida o conjunto de dados fornecido e classifica a confiabilidade das informações como confiável, suficiente ou não confiável. Para indicar a confiabilidade de um indivíduo, há várias combinações possíveis de dados para avaliar a pontuação de confiabilidade, que pode variar entre 10, 20 ou 30. ![](https://262277803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbVxCOSyBojfSIE5fcpfH%2Fuploads%2Fgit-blob-e12d3d95665559f34874673ca5c6f0fd36836f19%2Ftable.png?alt=media) **Seção**: `globalIdentityVerifications` **Países suportados:** Argentina, Austrália\*, Áustria, Bélgica, Brasil, Canadá\*, China, Chile, Colômbia, Chéquia, Dinamarca, Finlândia, França, Alemanha, Gana, Gibraltar, Grécia, Hong Kong\*, Índia\*, Indonésia, Irlanda, Itália, Japão, Quênia, Luxemburgo, Malásia, México, Países Baixos, Nova Zelândia, Nigéria, Noruega, Filipinas, Polônia, Portugal, Singapura, Eslováquia, África do Sul, Espanha, Suécia, Suíça, Turquia, Reino Unido, Estados Unidos e Vietnã. **Observação:** Austrália, Canadá, Hong Kong e Índia exigem autorização para consulta antes que seja possível acessar os dados (processo de integração). {% tabs %} {% tab title="Parâmetros" %} | Atributo | Tipo | Descrição | Obrigatório | | ------------ | -------------------- | ------------------------------------------------------------- | ------------------------- | | nome | cadeia de caracteres | Nome completo do indivíduo. | Sim | | birthDate | cadeia de caracteres | Data de nascimento do indivíduo. | Sim | | address | cadeia de caracteres | Endereço do indivíduo. | Sim | | phoneNumber | cadeia de caracteres | Número de telefone do indivíduo. | Sim | | nationalId | cadeia de caracteres | Um número ou documento de identificação emitido pelo governo. | Sim/Não (depende do país) | | zipCode | cadeia de caracteres | Código postal do endereço do indivíduo. | Sim | | countryCode | cadeia de caracteres | Código do país do indivíduo. | Sim | | dateFormat | cadeia de caracteres | Formato da data de nascimento. | Não | | {% endtab %} | | | | {% tab title="Exemplo de corpo" %} ```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 %} **Observação:** Alguns campos retornados por esta API são opcionais e sua presença não pode ser garantida. {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ---------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | dados | objeto | Objeto contendo os dados principais. | | data.detailList | cadeia de caracteres | Detalhes relacionados à consulta. | | data.adaptation | cadeia de caracteres | Indicador de adaptação. | | data.messages | array | Lista de mensagens que fornecem detalhes sobre o nível de correspondência de cada dado. | | data.messages\[].value | cadeia de caracteres | Indica o nível de correspondência dos dados (correspondência completa, sem correspondência, correspondência parcial etc.). | | data.messages\[].code | cadeia de caracteres | Código que indica o tipo de dado analisado (FIRSTNAME, COMPLETENAME, PHONENUMBER etc.). | | data.detailCode | cadeia de caracteres | Código detalhado específico para o processo ou solicitação. | | data.query | objeto | Informações sobre a consulta realizada. | | data.query.options | cadeia de caracteres | Valor interno que indica o tipo de busca da consulta. | | data.reliability | cadeia de caracteres | Indicador de confiabilidade (10, 20, 30). | | data.statusCode | cadeia de caracteres | Status da transação. Consulte nosso guia de status. | | statusCode | cadeia de caracteres | Refere-se apenas ao status desta consulta, não à transação inteira. [Consulte nosso guia de status](/caf-api/caf-api-pt-br/api-core/transaction-details/background-check.md) | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "data": { "detailList": "", "adaptation": "0", "messages": [ { "value": "Correspondência completa encontrada para Nome Completo", "code": "1MT-BR-GVT2-COMPLETENAME" }, { "value": "Correspondência completa encontrada para a inicial do nome", "code": "1MT-BR-GVT2-FIRSTINITIAL" }, { "value": "Correspondência completa encontrada para o primeiro nome/nome próprio", "code": "1MT-BR-GVT2-FIRSTNAME" }, { "value": "Correspondência completa encontrada para o sobrenome", "code": "1MT-BR-GVT2-LASTNAME" }, { "value": "Correspondência completa encontrada para o código postal/CEP", "code": "1MT-BR-GVT2-POSTALCODE" }, { "value": "Correspondência completa encontrada para estado/província", "code": "1MT-BR-GVT2-PROVINCE" }, { "value": "A fonte de dados não contém o elemento Descritores de subpremissa fornecido nas linhas de endereço", "code": "4MT-BR-GVT2-SUBPREMISE" }, { "value": "A fonte de dados não contém o elemento Número de telefone", "code": "4MT-BR-GVT2-PHONENUMBER" }, { "value": "Correspondência parcial encontrada no elemento Linhas de endereço", "code": "3MT-BR-GVT2-ADDRESS" }, { "value": "Correspondência completa encontrada para a data de nascimento", "code": "1MT-BR-GVT2-DATEOFBIRTH" }, { "value": "Correspondência completa encontrada para o dia de nascimento", "code": "1MT-BR-GVT2-DAYOFBIRTH" }, { "value": "Correspondência completa encontrada para o mês de nascimento", "code": "1MT-BR-GVT2-MONTHOFBIRTH" }, { "value": "Correspondência completa encontrada para o ano de nascimento", "code": "1MT-BR-GVT2-YEAROFBIRTH" }, { "value": "Correspondência completa encontrada para o sobrenome", "code": "1AU-400-LASTNAME" }, { "value": "Correspondência completa encontrada para o primeiro nome/nome próprio", "code": "1AU-350-FIRSTNAME" }, { "value": "Correspondência completa encontrada para a inicial do nome", "code": "1AU-375-FIRSTINITIAL" }, { "value": "Correspondência completa encontrada para Nome Completo", "code": "1AU-425-COMPLETENAME" }, { "value": "Correspondência completa encontrada para o ano de nascimento", "code": "1AU-625-YEAROFBIRTH" }, { "value": "Correspondência completa encontrada para o mês de nascimento", "code": "1AU-600-MONTHOFBIRTH" }, { "value": "Correspondência completa encontrada para o dia de nascimento", "code": "1AU-575-DAYOFBIRTH" }, { "value": "Correspondência completa encontrada para a data de nascimento", "code": "1AU-550-DATEOFBIRTH" }, { "value": "Correspondência parcial encontrada no elemento Linhas de endereço", "code": "3AU-200-ADDRESS" }, { "value": "Nenhuma correspondência foi encontrada para rua/via pública", "code": "2AU-075-THOROUGHFARE" }, { "value": "Nenhuma correspondência foi encontrada para número da casa/número da rua", "code": "2AU-050-HOUSENUMBER" }, { "value": "Nenhuma correspondência foi encontrada para distrito", "code": "2AU-225-DISTRICT" }, { "value": "Correspondência completa encontrada para estado/província", "code": "1AU-325-PROVINCE" }, { "value": "Correspondência completa encontrada para o código postal/CEP", "code": "1AU-275-POSTALCODE" }, { "value": "Correspondência completa para verificação 1+1", "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": "Códigos" } ], "detailCode": "WS-2253205.2024.4.27.17.1.51.23", "query": { "options": "identityverify;messageverbose" }, "reliability": "10" } } ``` {% endtab %} {% tab title="Regras de Validação" %} | Regra | Descrição | | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | Informação básica com correspondência confiável | Indica se as informações básicas do indivíduo (nome, endereço, data de nascimento, número do documento e número de telefone) correspondem. | | Informação básica com correspondência suficiente | Indica se as informações básicas do indivíduo (nome, endereço, data de nascimento, número do documento e número de telefone) correspondem parcialmente. | | {% 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.caf.io/caf-api/caf-api-pt-br/api-core/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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.