Saltar para o conteúdo principal
POST
Verifica uma carta de condução ou cartão de identificação estadual dos EUA face aos registos de veículos motorizados do estado emissor, confirmando o número da carta, os nomes do titular e a data de nascimento. A Didit disponibiliza este serviço através de POST /v3/database-validation/ para que possa verificar os dados submetidos face à fonte oficial e receber resultados de correspondência normalizados. Formato de entrada: document_number aceita o número da carta de condução ou do cartão de identificação estadual dos EUA (4-20 letras e dígitos; hífenes 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

Dados de entrada

  • Dados de entrada obrigatórios: first_name, last_name, document_number, driver_license_state
  • Dados de entrada opcionais: middle_name, date_of_birth, date_of_issue, expiration_date, gender, document_type, vendor_data
  • Consentimento: Não obrigatório
  • Disponibilidade no fluxo: 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 alfa-3 para este serviço de base de dados.Exemplo: USA
string
padrão:"usa_driver_license_dmv"
obrigatório
Matriz que contém este ID de serviço. Fixar o serviço mantém o pedido circunscrito a esta base de dados específica.Exemplo: usa_driver_license_dmv
string
padrão:"John"
obrigatório
Nome próprio a validar.Exemplo: John
string
padrão:"Doe"
obrigatório
Apelido a validar.Exemplo: Doe
string
padrão:"SAMPLE-DOC-12345"
obrigatório
Número do documento extraído ou fornecido pelo utilizador.Exemplo: SAMPLE-DOC-12345
string
padrão:"Sample State"
obrigatório
Estado ou região que emitiu a carta de condução.Exemplo: Sample State
string
Segundo nome, 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 base de dados.Exemplo: 1990-01-01
string
Valor de expiration_date exigido por este serviço de base de dados.Exemplo: 1990-01-01
string
Valor do género, quando exigido pela base de dados.Valores permitidos: M (masculino), F (feminino), X (outro ou desconhecido).Exemplo: M
string
Tipo de documento a validar neste serviço de base de dados.Valores permitidos: DL (carta de condução), ID (documento de identificação nacional).Exemplo: DL
string
padrão:"user-1234"
A sua referência estável de utilizador para esta pessoa, como o seu ID de utilizador interno. O Didit utiliza-a para associar verificações independentes ao mesmo utilizador final e reduzir o ruído na deteção de duplicados.Exemplo: user-1234

Regras de entrada e notas de validação

  • Número da carta de condução ou do documento de identificação estadual dos EUA (4-20 letras e dígitos; hífenes e espaços permitidos)
  • document_number deve ter entre 4 e 20 carateres.
  • 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 (TX) ou o nome (Texas) do estado emissor.
  • As cartas de condução da Califórnia e da Pensilvânia não são verificadas por este serviço.

Como chamar

Dados devolvidos

Os campos exatos disponibilizados em source_data dependem do que o registo devolve. O exemplo gerado para usa_driver_license_dmv documenta atualmente este formato normalizado:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • middle_name

Preços e SLAs

As consultas dos Estados Unidos – Carta de condução (DMV) são faturadas apenas quando a Didit recebe um resultado conclusivo da fonte de validação.
  • Preço por chamada: $1.99 USD.
  • Faturação: por consulta bem-sucedida. Não é cobrado quando o registo estiver inacessível, quando faltarem campos obrigatórios ou quando o pedido for rejeitado antes de alcançar a fonte.
  • Latência: p95 típico < 2 s.
  • Disponibilidade: 99.9% por trimestre da parte da Didit; a disponibilidade da fonte a jusante varia consoante o país e o conjunto de dados.

Continuar a ler

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