Pular para o conteúdo principal
POST
Identifica pessoas (nomes, data de nascimento, endereços, telefones, e-mails, números nacionais de identificação) e uma pontuação de correspondência entre nomes a partir de um e-mail e/ou número de telefone, por meio de uma rede global de inteligência de risco. A cobrança é feita por requisição. A Didit disponibiliza este serviço pelo POST /v3/database-validation/ para que você confronte os dados enviados com a rede de identidade conectada e receba resultados de correspondência normalizados. Esta é uma rede de enriquecimento de terceiros, não um registro governamental oficial: não apresente os resultados dela como verificação com base em fonte primária.

Cobertura

  • Cobertura: 50+ mercados
  • País: Global
  • ID do serviço: glb_identity_enrichment
  • Domínio de dados: Identidade
  • Categoria: IdentityEnrichment

Entradas

  • Entradas obrigatórias: —
  • Entradas opcionais: email, phone, first_name, last_name, full_name, country_of_residence, vendor_data
  • Consentimento: Obrigatório
  • Disponibilidade em fluxos: Somente API independente
  • Cobertura: 50+ mercados
  • Preço: $0.20 por consulta bem-sucedida
Este serviço não é oferecido como etapa de Validação de banco de dados em um fluxo. Isso restringe onde a verificação é executada, não o que você pode enviar a ela: chame-o pela API independente, na qual você fornece as entradas diretamente.

Parâmetros do corpo

string
padrão:"GLB"
obrigatório
Código de país ISO 3166-1 alfa-3 deste serviço de banco de dados.Exemplo: GLB
string
padrão:"glb_identity_enrichment"
obrigatório
Array que contém o ID deste serviço. Fixar o serviço mantém a requisição restrita a este banco de dados específico.Exemplo: glb_identity_enrichment
Consentimento explícito do usuário final para este serviço.Exemplo: true
string
padrão:"john.doe@example.com"
Endereço de e-mail.Exemplo: john.doe@example.com
string
padrão:"+15550101000"
Número de telefone em formato internacional.Exemplo: +15550101000
string
padrão:"John"
Nome a ser validado.Exemplo: John
string
padrão:"Doe"
Sobrenome a ser validado.Exemplo: Doe
string
Nome civil completo a ser validado.Exemplo: John Doe
string
padrão:"US"
País de residência opcional, em código ISO 3166-1 alfa-2. Usado apenas para direcionar a consulta de identidade.Exemplo: US
string
padrão:"user-1234"
Sua referência estável de usuário para esta pessoa, como o ID interno do usuário. A Didit a usa para vincular verificações independentes ao mesmo usuário final e reduzir o ruído na detecção de duplicidades.Exemplo: user-1234

Regras de entrada e observações de validação

  • Informe pelo menos um entre email e phone: eles são as chaves de consulta. Uma requisição sem nenhum dos dois não consegue realizar a consulta de enriquecimento e é rejeitada antes da consulta à fonte (sem cobrança).
  • Adicione um nome sempre que o tiver: a fonte pontua a consulta com base nele. Envie first_name + last_name: esses são os campos que o mapa validation da resposta compara. Uma requisição que envia apenas full_name ainda é pontuada pela fonte, mas retorna com validation vazio e match_type nulo no nível superior.
  • country_of_residence é um código ISO 3166-1 alfa-2 usado para direcionar a consulta.
  • Toda consulta concluída é cobrada, inclusive uma que não identifica nenhuma pessoa (persons_found: 0). Somente uma requisição rejeitada antes da consulta, sem email nem phone informados, é gratuita.

Como chamar

Dados retornados

Os campos exatos expostos em source_data dependem do que o registro de empresas retorna. O exemplo gerado para glb_identity_enrichment documenta atualmente este formato normalizado:
  • first_name
  • last_name
  • persons_found

Preços e SLAs

As consultas de Global - Identity Enrichment são cobradas somente quando a Didit recebe um resultado conclusivo da fonte de validação.
  • Preço por chamada: $0.20 USD.
  • Faturamento: por consulta bem-sucedida. Você não é cobrado quando o registro está inacessível, quando faltam campos obrigatórios ou quando a requisição é rejeitada antes de chegar à fonte.
  • Latência: p95 típico < 2 s.
  • Disponibilidade: 99.9% por trimestre do lado da Didit. A disponibilidade da fonte de dados varia conforme o país e o conjunto de dados.

Continue a leitura

Última modificação em 1 de novembro de 2026