es_dni

Documento de identidade espanhol (DNI)

Verifique que um DNI espanhol é válido, está dentro do prazo e pertence à pessoa certa.

Categoria: Identidade
País: Espanha
Campos extraídos: 14 campos
Custo: 1 crédito

DNI espanhol (espécime) — EspécimeExperimente na demo

O DNI é o documento mais pedido em Espanha e o que mais vezes se guarda sem necessidade. A Constaia lê as duas faces, calcula a letra de controlo, valida a MRZ e compara-a com os dados impressos. Recebe um veredicto com motivos e, se quiser, apenas os campos mínimos.

Uma fotografia de cada face, ou um PDF com as duas, conta como 1 crédito.
Com storage "none" o ficheiro é apagado assim que a análise termina: nunca fica com uma cópia do documento.
Uma letra e uma MRZ corretas não provam que o documento é autêntico; os avisos assinalam fotografias de ecrã ou possíveis edições.

O que verifica

Letra do NIF/NIE. Recalcula-se o carácter de controlo (módulo 23).
MRZ ICAO 9303. Dígitos de controlo da zona de leitura ótica.
MRZ vs. dados impressos. A MRZ coincide com os dados visíveis.
Validade. Não caducado na data de referência.
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.

Campos extraídos

Número do documentodocument_number
Nome própriofirst_name
Primeiro apelidolast_name_1
Segundo apelidolast_name_2
Sexosex
Nacionalidadenationality
Data de nascimentobirth_date
Data de validadeexpiry_date
Data de emissãoissue_date
Número de suportesupport_number
Moradaaddress
Local de nascimentobirth_place
Nome dos paisparents
Mrzmrz

Onde se usa

Exemplo de pedido

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@dni_valid.jpg" \
  -F 'options={
    "expect": "es_dni",
    "checks": {
      "not_expired": true,
      "holder": {
        "full_name": "María García López"
      }
    },
    "storage": "none"
  }'

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

Exemplo de resposta

Dados fictícios. Resposta abreviada.

200 OK · application/json

{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "es_dni",
    "label": "Documento de identidade espanhol (DNI)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "es_dni"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "O documento é: Documento de identidade espanhol (DNI)."
      }
    ]
  },
  "fields": {
    "document_number": {
      "value": "12345678Z",
      "confidence": 0.99,
      "validated": true
    },
    "first_name": {
      "value": "MARÍA",
      "confidence": 0.98,
      "validated": null
    },
    "last_name_1": {
      "value": "GARCÍA",
      "confidence": 0.97,
      "validated": null
    },
    "last_name_2": {
      "value": "LÓPEZ",
      "confidence": 0.96,
      "validated": null
    },
    "sex": {
      "value": "F",
      "confidence": 0.99,
      "validated": null
    },
    "nationality": {
      "value": "ESP",
      "confidence": 0.98,
      "validated": null
    },
    "birth_date": {
      "value": "1990-04-18",
      "confidence": 0.97,
      "validated": null
    },
    "expiry_date": {
      "value": "2031-03-12",
      "confidence": 0.96,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "nif_check_digit",
      "passed": true,
      "message": "A letra do NIF está correta."
    },
    {
      "code": "mrz_checksums",
      "passed": true,
      "message": "Os dígitos de controlo da MRZ estão corretos."
    },
    {
      "code": "mrz_matches_visual",
      "passed": true,
      "message": "A MRZ coincide com os dados impressos."
    }
  ],
  "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