curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cpf_facial" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "tax_number=11111111111" \
-F "selfie=@./selfie.jpg"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="BRA",
services=["bra_cpf_facial"],
consent=True,
tax_number="11111111111",
vendor_data="user-1234",
selfie=open("selfie.jpg", "rb"),
)
print(result)
import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "BRA",
services: ["bra_cpf_facial"],
consent: true,
tax_number: "11111111111",
vendor_data: "user-1234",
selfie: await fileFromPath("selfie.jpg"),
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "BRA",
Services: didit.Some([]string{"bra_cpf_facial"}),
Consent: didit.Bool(true),
TaxNumber: didit.String("11111111111"),
VendorData: didit.String("user-1234"),
Selfie: didit.Some(didit.FileFromPath("selfie.jpg")),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.nio.file.Path;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("BRA")
.services(List.of("bra_cpf_facial"))
.consent(true)
.taxNumber("11111111111")
.vendorData("user-1234")
.selfie(Path.of("selfie.jpg"))
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'BRA',
'services' => ['bra_cpf_facial'],
'consent' => true,
'tax_number' => '11111111111',
'vendor_data' => 'user-1234',
'selfie' => File::fromPath('selfie.jpg'),
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "BRA",
services: ["bra_cpf_facial"],
consent: true,
tax_number: "11111111111",
vendor_data: "user-1234",
selfie: Pathname("selfie.jpg")
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "BRA",
Services = new string[] { "bra_cpf_facial" },
Consent = true,
TaxNumber = "11111111111",
VendorData = "user-1234",
Selfie = FileUpload.FromPath("selfie.jpg"),
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"date_of_birth": "1990-01-01",
"face_match_probability": "Altíssima probabilidade",
"face_match_score": "0.990",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000",
"verifications": {
"identification_number": true
}
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "INCONCLUSIVE",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
🇧🇷 Brasil
API de CPF + face match (Datavalid) no Brasil: ID Match
Consulta de CPF + biometria facial (Datavalid) em base oficial do Brasil com a Didit. A partir de $0.45 por chamada, sem contratos nem mínimos.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cpf_facial" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "tax_number=11111111111" \
-F "selfie=@./selfie.jpg"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="BRA",
services=["bra_cpf_facial"],
consent=True,
tax_number="11111111111",
vendor_data="user-1234",
selfie=open("selfie.jpg", "rb"),
)
print(result)
import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "BRA",
services: ["bra_cpf_facial"],
consent: true,
tax_number: "11111111111",
vendor_data: "user-1234",
selfie: await fileFromPath("selfie.jpg"),
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "BRA",
Services: didit.Some([]string{"bra_cpf_facial"}),
Consent: didit.Bool(true),
TaxNumber: didit.String("11111111111"),
VendorData: didit.String("user-1234"),
Selfie: didit.Some(didit.FileFromPath("selfie.jpg")),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.nio.file.Path;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("BRA")
.services(List.of("bra_cpf_facial"))
.consent(true)
.taxNumber("11111111111")
.vendorData("user-1234")
.selfie(Path.of("selfie.jpg"))
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'BRA',
'services' => ['bra_cpf_facial'],
'consent' => true,
'tax_number' => '11111111111',
'vendor_data' => 'user-1234',
'selfie' => File::fromPath('selfie.jpg'),
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "BRA",
services: ["bra_cpf_facial"],
consent: true,
tax_number: "11111111111",
vendor_data: "user-1234",
selfie: Pathname("selfie.jpg")
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "BRA",
Services = new string[] { "bra_cpf_facial" },
Consent = true,
TaxNumber = "11111111111",
VendorData = "user-1234",
Selfie = FileUpload.FromPath("selfie.jpg"),
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"date_of_birth": "1990-01-01",
"face_match_probability": "Altíssima probabilidade",
"face_match_score": "0.990",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000",
"verifications": {
"identification_number": true
}
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "INCONCLUSIVE",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
SERPRO Datavalid v4 pf-facial: valida o CPF (obrigatório) na Receita Federal e compara a selfie ao vivo (obrigatória) com o retrato da CNH armazenado no Senatran. Opcionalmente, também confere nome e data de nascimento. A Didit disponibiliza este serviço por meio de
POST /v3/database-validation/ para que você possa verificar os dados enviados na fonte oficial e receber resultados de correspondência normalizados.
Cobertura
- Cobertura: ~50%
- País: Brasil
- ID do serviço:
bra_cpf_facial - Domínio de dados: Biométrico
- Categoria: NationalIDRegistry
Entradas
| Campo | Obrigatório | Exemplo |
|---|---|---|
tax_number | Sim | 11111111111 |
selfie | Sim | @./selfie.jpg |
first_name | Não | John |
last_name | Não | Doe |
date_of_birth | Não | 1990-01-01 |
vendor_data | Não | user-1234 |
- Entradas obrigatórias:
tax_number,selfie - Entradas opcionais:
first_name,last_name,date_of_birth,vendor_data - Consentimento: Obrigatório
- Disponibilidade no workflow: Disponível no workflow
- Cobertura: ~50%
- Preço: $0.45 por consulta bem-sucedida
Parâmetros do corpo
string
padrão:"BRA"
obrigatório
Código de país ISO 3166-1 alfa-3 deste serviço de banco de dados.Exemplo:
BRAstring
padrão:"bra_cpf_facial"
obrigatório
Array que contém o ID deste serviço. Fixar o serviço mantém a requisição restrita exatamente a este banco de dados.Exemplo:
bra_cpf_facialboolean
padrão:"true"
obrigatório
Consentimento explícito do usuário final para este serviço.Exemplo:
truestring
padrão:"11111111111"
obrigatório
Número de identificação fiscal.Exemplo:
11111111111file
obrigatório
Arquivo de imagem da selfie a ser enviado para a validação no banco de dados biométrico. Formatos aceitos: JPEG, PNG ou WebP.Exemplo:
@./selfie.jpgstring
Nome a ser validado.Exemplo:
Johnstring
Sobrenome a ser validado.Exemplo:
Doestring
Data de nascimento no formato
YYYY-MM-DD.Exemplo: 1990-01-01string
padrão:"user-1234"
Sua referência estável para esta pessoa, como o ID interno do usuário. A Didit a usa para vincular verificações avulsas ao mesmo usuário final e reduzir o ruído na detecção de duplicatas.Exemplo:
user-1234Regras de entrada e observações de validação
- CPF brasileiro (exatamente 11 dígitos)
tax_numberdeve conter apenas dígitos; remova espaços, hífens e pontuação antes de enviar a requisição.tax_numberdeve ter exatamente 11 caracteres.
Como chamar
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cpf_facial" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "tax_number=11111111111" \
-F "selfie=@./selfie.jpg"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="BRA",
services=["bra_cpf_facial"],
consent=True,
tax_number="11111111111",
vendor_data="user-1234",
selfie=open("selfie.jpg", "rb"),
)
print(result)
import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "BRA",
services: ["bra_cpf_facial"],
consent: true,
tax_number: "11111111111",
vendor_data: "user-1234",
selfie: await fileFromPath("selfie.jpg"),
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "BRA",
Services: didit.Some([]string{"bra_cpf_facial"}),
Consent: didit.Bool(true),
TaxNumber: didit.String("11111111111"),
VendorData: didit.String("user-1234"),
Selfie: didit.Some(didit.FileFromPath("selfie.jpg")),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.nio.file.Path;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("BRA")
.services(List.of("bra_cpf_facial"))
.consent(true)
.taxNumber("11111111111")
.vendorData("user-1234")
.selfie(Path.of("selfie.jpg"))
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'BRA',
'services' => ['bra_cpf_facial'],
'consent' => true,
'tax_number' => '11111111111',
'vendor_data' => 'user-1234',
'selfie' => File::fromPath('selfie.jpg'),
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "BRA",
services: ["bra_cpf_facial"],
consent: true,
tax_number: "11111111111",
vendor_data: "user-1234",
selfie: Pathname("selfie.jpg")
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "BRA",
Services = new string[] { "bra_cpf_facial" },
Consent = true,
TaxNumber = "11111111111",
VendorData = "user-1234",
Selfie = FileUpload.FromPath("selfie.jpg"),
});
Console.WriteLine(JsonSerializer.Serialize(result));
Toda chamada bem-sucedida retorna HTTP 200. O campo outcome_code informa o que de fato aconteceu, distinguindo, por exemplo, uma divergência biométrica real (BIOMETRIC_NO_MATCH) de uma selfie que não pôde ser lida (BIOMETRIC_IMAGE_UNUSABLE). O status exibido é o status padrão do recurso; as ações de Correspondência parcial / Sem correspondência que você configurou podem substituí-lo.MATCH: o registro confirmou a identidade e todos os campos verificados corresponderam.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"date_of_birth": "1990-01-01",
"face_match_probability": "Altíssima probabilidade",
"face_match_score": "0.990",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000",
"verifications": {
"identification_number": true
}
},
"validation": {
"identification_number": "full_match"
}
}
]
}
NO_MATCH: o registro não retornou correspondência para os dados enviados.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
BIOMETRIC_NO_MATCH: a pontuação de correspondência facial ficou abaixo do limiar de aceitação; a pessoa na selfie não é a mesma da foto do registro.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
BIOMETRIC_IMAGE_UNUSABLE: não foi possível processar a selfie (vazia, sem rosto, de baixa qualidade ou o registro não conseguiu lê-la). Peça ao usuário que tire a selfie novamente.{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
INCONCLUSIVE: o registro confirmou o CPF (e o nome e a data de nascimento que você enviou), mas não foi possível comparar o rosto: não há foto de referência cadastrada para esse CPF, ou a selfie não pôde ser usada (nenhum rosto encontrado, tamanho de imagem incorreto, baixa qualidade ou mais de um rosto). Os campos confirmados permanecem em validation, então match_type os reflete, mas a verificação facial obrigatória não é concluída e, por isso, a verificação é enviada para revisão. Solicite uma nova selfie ou recorra à verificação de documento para pessoas sem foto cadastrada.{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "INCONCLUSIVE",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
Dados retornados
Os campos exatos exibidos emsource_data dependem do que o registro de empresas retorna. O exemplo gerado para bra_cpf_facial documenta atualmente este formato normalizado:
date_of_birthfirst_nameidentification_numberlast_namename_match_score
Preços e SLAs
As consultas de Brasil - CPF + correspondência facial (Datavalid) são cobradas apenas quando a Didit recebe um resultado conclusivo da fonte de validação.- Preço por chamada: $0.45 USD.
- Faturamento: por consulta bem-sucedida. Você não é cobrado quando o cadastro estiver 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.
Sobre esta fonte
Esta é a fonte oficial do governo: o Datavalid do SERPRO, operado pelo serviço federal de processamento de dados do Brasil. O CPF é verificado na Receita Federal, e a selfie é comparada com o retrato registrado para essa pessoa na Senatran, o registro nacional de condutores habilitados. Como o retrato vem do registro da CNH (carteira de motorista), somente quem tem CNH possui uma foto cadastrada. É isso que limita a cobertura a cerca de 50% da população adulta: os dados são oficiais, mas não existem para nenhum brasileiro que nunca teve carteira de motorista. Precisa de uma cobertura maior? Use BRA - Unico IDCloud (CPF + selfie). Ele alcança cerca de 96% dos adultos brasileiros por meio do cadastro biométrico privado da Unico e custa $0.20, contra $0.45 aqui. Escolha o Datavalid quando você precisar especificamente do cadastro do governo como fonte de referência; escolha o IDCloud quando precisar verificar todo mundo.Continue a leitura
Última modificação em 1 de novembro de 2026