us_driver_license

Carta de condução dos EUA

Leia as duas faces de uma carta de condução norte-americana, descodifique o código AAMVA e verifique validade, idade e titular.

Categoria: Cartas de condução
País: Estados Unidos
Campos extraídos: 28 campos
Custo: 1 crédito

us_driver_licensespecimen

Número do documento
Estado emissor
Nome próprio
Nome do meio
Apelido
Name suffix
Data de nascimento
Data de emissão
Data de validade

Cada estado tem o seu próprio design, mas o verso tem um código de barras PDF417 segundo a norma AAMVA. A Constaia descodifica-o, compara-o com a frente impressa e verifica a validade, a data de nascimento e o titular.

Frente e verso contam como 1 crédito.
Um código que coincide com a frente não prova que o cartão seja autêntico. A Constaia não faz verificações biométricas.
A lei federal DPPA limita o uso de dados pessoais dos registos de viação dos estados; guarde apenas o necessário.

O que verifica

Código PDF417 (AAMVA). O verso é descodificado e comparado com a frente.
Identificadores nacionais. Checksum ou formato oficial do número (NIF, CPF, CURP, RUT…).us_dl, us_zip
Código postal. Formato do código postal do país.
Titular. Nome, número ou data de nascimento coincidem com o esperado.
Idade. Idade mínima ou máxima a partir da data de nascimento.
Validade. Não caducado na data de referência.
Formulário I-9. Indica se o documento é da lista A, B ou C.B

Campos extraídos

Número do documentodocument_number
Estado emissorissuing_state
Nome própriofirst_name
Nome do meiomiddle_name
Apelidolast_name
Name suffixname_suffix
Data de nascimentobirth_date
Data de emissãoissue_date
Data de validadeexpiry_date
Sexosex
Heightheight
Weightweight
Eye coloreye_color
Hair colorhair_color
Moradaaddress
Postal codepostal_code
Conforme com REAL IDreal_id_compliant
Dddd
Organ donororgan_donor
Veteranveteran
Under 21 untilunder_21_until
Federal limits applyfederal_limits_apply
Classclass
Restriçõesrestrictions
Averbamentos (endorsements)endorsements
Commercialcommercial
Tipo de autorizaçãopermit_type
Barcode databarcode_data

Exemplo de pedido

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@us_driver_license_specimen.jpg" \
  -F 'options={
    "expect": "us_driver_license",
    "checks": {
      "not_expired": true,
      "min_age_years": 21,
      "holder": {
        "full_name": "Jordan Specimen"
      }
    },
    "storage": "none"
  }'

Experimente sem custo com uma chave ck_test_ e o ficheiro us_driver_license_specimen.jpg.

Exemplo de resposta

Dados fictícios. Resposta abreviada.

200 OK · application/json

{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "us_driver_license",
    "label": "Carta de condução dos EUA",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "us_driver_license"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "O documento é: Carta de condução dos EUA."
      }
    ]
  },
  "fields": {
    "document_number": {
      "value": "D1234567",
      "confidence": 0.99,
      "validated": true
    },
    "first_name": {
      "value": "JORDAN",
      "confidence": 0.98,
      "validated": null
    },
    "middle_name": {
      "value": "LEE",
      "confidence": 0.97,
      "validated": null
    },
    "last_name": {
      "value": "SPECIMEN",
      "confidence": 0.96,
      "validated": null
    },
    "birth_date": {
      "value": "1994-03-08",
      "confidence": 0.99,
      "validated": null
    },
    "sex": {
      "value": "M",
      "confidence": 0.98,
      "validated": null
    },
    "issuing_state": {
      "value": "CA",
      "confidence": 0.97,
      "validated": null
    },
    "license_class": {
      "value": "C",
      "confidence": 0.96,
      "validated": null
    },
    "issue_date": {
      "value": "2023-05-17",
      "confidence": 0.99,
      "validated": null
    },
    "expiry_date": {
      "value": "2028-03-08",
      "confidence": 0.98,
      "validated": null
    },
    "real_id_compliant": {
      "value": true,
      "confidence": 0.97,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "aamva_barcode_matches_front",
      "passed": true,
      "message": "O código PDF417 coincide com a frente."
    },
    {
      "code": "not_expired",
      "passed": true,
      "message": "Válido na data de referência."
    },
    {
      "code": "min_age_years",
      "passed": true,
      "message": "O titular cumpre a idade mínima."
    },
    {
      "code": "holder_match",
      "passed": true,
      "message": "O titular coincide."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 2
  }
}

FAQ

A Constaia prova que o documento é autêntico?

Não. Verifica o tipo, a coerência dos dados e as suas regras, e assinala sinais como possível edição ou fotografia de ecrã. Isso não prova autenticidade.

É guardada uma cópia do documento?

Não, a menos que o peça. Com storage "none" (por omissão) o ficheiro é apagado quando a análise termina.

Outros documentos

E para que conste…

Crie a sua conta, copie a chave de teste e valide o seu primeiro documento em cinco minutos.

Criar conta grátis Falar com vendas