Pular para o conteúdo principal
POST
Verifica uma carteira de habilitação dos EUA ou documento de identidade estadual consultando os registros de veículos automotores do estado emissor, confirmando o número da carteira de habilitação, o nome do titular e a data de nascimento. A Didit disponibiliza este serviço via POST /v3/database-validation/ para que você possa verificar os dados enviados em relação à fonte oficial e receber resultados de correspondência normalizados. Formato de entrada: document_number aceita o número da carteira de habilitação dos EUA ou do documento de identidade estadual (4 a 20 letras e dígitos; traços e espaços permitidos).

Cobertura

  • Cobertura: ~ 90%
  • País: Estados Unidos
  • ID do serviço: usa_driver_license_dmv
  • Domínio de dados: Documento
  • Categoria: DriverLicence

Entradas

  • Entradas obrigatórias: first_name, last_name, document_number, driver_license_state
  • Entradas opcionais: middle_name, date_of_birth, date_of_issue, expiration_date, gender, document_type, vendor_data
  • Consentimento: Não obrigatório
  • Disponibilidade no fluxo de verificação (workflow): Disponível no fluxo
  • Cobertura: ~ 90%
  • Preço: $1.99 por consulta bem-sucedida

Parâmetros do corpo

string
padrão:"USA"
obrigatório
Código de país ISO 3166-1 alpha-3 para este serviço de banco de dados.Exemplo: USA
string
padrão:"usa_driver_license_dmv"
obrigatório
Array contendo este ID de serviço. Fixar o serviço mantém a requisição restrita a este banco de dados específico.Exemplo: usa_driver_license_dmv
string
padrão:"John"
obrigatório
Primeiro nome a ser validado.Exemplo: John
string
padrão:"Doe"
obrigatório
Sobrenome a ser validado.Exemplo: Doe
string
padrão:"SAMPLE-DOC-12345"
obrigatório
Número do documento extraído ou fornecido pelo usuário.Exemplo: SAMPLE-DOC-12345
string
padrão:"Sample State"
obrigatório
Estado ou região que emitiu a carteira de motorista.Exemplo: Sample State
string
Nome do meio, quando disponível.Exemplo: Demo
string
Data de nascimento no formato YYYY-MM-DD.Exemplo: 1990-01-01
string
Valor de date_of_issue exigido por este serviço de banco de dados.Exemplo: 1990-01-01
string
Valor de expiration_date exigido por este serviço de banco de dados.Exemplo: 1990-01-01
string
Valor do gênero, quando exigido pelo banco de dados.Valores permitidos: M (masculino), F (feminino), X (outro ou desconhecido).Exemplo: M
string
Tipo de documento a ser validado em relação a este serviço de banco de dados.Valores permitidos: DL (carteira de motorista), ID (documento de identidade nacional).Exemplo: DL
string
padrão:"user-1234"
Sua referência estável de usuário para esta pessoa, como o seu ID interno de usuário. A Didit a utiliza para vincular verificações avulsas ao mesmo usuário final e reduzir ruídos na detecção de duplicatas.Exemplo: user-1234

Regras de entrada e notas de validação

  • Número da carteira de motorista ou de documento de identidade estadual dos EUA (4-20 letras e dígitos; traços e espaços permitidos)
  • document_number deve ter de 4 a 20 caracteres.
  • document_number deve corresponder a [A-Za-z0-9][A-Za-z0-9 -]{2,18}[A-Za-z0-9].
  • Envie driver_license_state como o código de duas letras do estado emissor (TX) ou o nome (Texas).
  • Carteiras de motorista da Califórnia e da Pensilvânia não são verificadas por este serviço.

Como chamar

Dados retornados

Os campos exatos disponibilizados em source_data dependem do que o registro retorna. O exemplo gerado para usa_driver_license_dmv documenta atualmente esta estrutura normalizada:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • middle_name

Preços e SLAs

As consultas de Carteira de Motorista (DMV) dos Estados Unidos são faturadas apenas quando a Didit recebe um resultado conclusivo da fonte de validação.
  • Preço por chamada: $1.99 USD.
  • Faturamento: por consulta bem-sucedida. Você não é cobrado quando o registro está inacessível, quando campos obrigatórios estão ausentes 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 subjacente varia de acordo com o país e o conjunto de dados.

Continue lendo

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