API de verificación de DNI y NIE en España: número y fecha de caducidad

Actualizado en noviembre de 2026

Esta guía muestra cómo verificar DNI/NIE en España con la API de Verifik: el endpoint, sus parámetros, una solicitud que puedes pegar en la terminal, la respuesta y los errores documentados, y qué revisar al llevarlo a producción. Todo lo que sigue proviene de la documentación oficial del endpoint.

Sobre el documento: DNI/NIE en España

En España conviven dos números de identidad. El Documento Nacional de Identidad (DNI), que expide la Policía Nacional, tiene ocho dígitos y una letra de control. Los extranjeros residentes reciben un Número de Identidad de Extranjero (NIE), que empieza por X, Y o Z, seguido de siete dígitos y una letra de control.

El endpoint de Verifik acepta ambos (DNIES o NIE) y, a diferencia de la mayoría de endpoints latinoamericanos, valida la fecha de caducidad del documento en lugar de la fecha de nacimiento.

Para seguir esta guía con tu propia integración, abre una cuenta en Verifik y genera tu token de acceso.

Cómo consultar la API de DNI/NIE de España

Endpoint: GET https://api.verifik.co/v2/es/cedula. Envía tu token en la cabecera Authorization: Bearer. Parámetros, según la documentación:

Ejemplo de solicitud con valores de ejemplo (reemplázalos por los datos de tu usuario):

curl --location --request GET 'https://api.verifik.co/v2/es/cedula?documentType=DNIES&documentNumber=12345678Z&date=31/12/2030' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Respuesta 200 de la documentación (datos personales enmascarados):

{
  "data": {
    "documentType": "DNIES",
    "documentNumber": "12*****89",
    "fullName": "J*** P****",
    "names": [
      "J***",
      "P****"
    ]
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "January 16, 2024 3:44 PM"
  },
  "id": "ES001"
}

Una consulta exitosa devuelve HTTP 200 con un objeto data que contiene: documentType, documentNumber, fullName, names. Toda respuesta incluye además una signature (fecha y “Certified by Verifik.co”) y un id único que puedes guardar como evidencia de la verificación.

Errores documentados de /v2/es/cedula

• 401 UNAUTHORIZED (“Authentication required”): falta el token o no es válido; revisa la cabecera Authorization.
• 403 FORBIDDEN (“Access forbidden”): el token es válido pero no tiene acceso a este endpoint; revisa tu plan o permisos.
• 404 NotFound (“Record not found”): no se encontró registro; no lo trates como coincidencia y envía el caso a revisión o pide otro documento.
• 409 MissingParameter (“"date" is required”): falta un parámetro obligatorio o tiene un valor no válido; corrige la solicitud en vez de reintentarla igual.

Consejos de integración

• El parámetro date es la fecha de caducidad del documento en DD/MM/YYYY, no la de nacimiento. Etiqueta bien el campo del formulario.
• Calcula la letra de control (número módulo 23) antes de llamar a la API para detectar errores.
• Envía el número sin espacios ni guiones, con la letra (por ejemplo 12345678Z).
• El tratamiento de datos en España se rige por el RGPD y la LOPDGDD; minimiza los campos almacenados.

Datos personales y términos de uso

Las consultas de identidad tratan datos personales. Usa la API solo con una finalidad legítima que puedas documentar, como onboarding, prevención de fraude o verificación contractual, obtén el consentimiento cuando la ley local lo exija y conserva solo los campos que necesites. El uso se rige por los términos y condiciones de smartCHECK.

Precios

Cada solicitud exitosa consume créditos de tu plan de Verifik. Los planes vigentes y el costo por endpoint están en la página de precios de smartCHECK.

Guías y documentación relacionadas

• API de consulta de CIF/NIF en España
• Documentación del endpoint (español)
• Documentación en inglés

Empieza a probar

Crea una cuenta en Verifik para obtener tu token de API, o agenda una reunión si quieres revisar cobertura y volúmenes con el equipo.