Constaia

Introducción

Constaia es una API europea que responde si un documento es el que esperas y si es válido, con motivos, campos extraídos y retención cero por defecto.

Constaia es una API para validar, clasificar y extraer datos de documentos con IA. Está pensada para formularios de inscripción, altas de clientes, licencias, expedientes y cualquier flujo en el que alguien te sube un documento y tú tienes que decidir si sirve.

La pregunta que responde

La mayoría de las APIs de documentos te devuelven texto o campos. Constaia responde a otra pregunta:

¿Es este documento un X válido?

Tú dices qué esperas (expect: "es_dni") y qué reglas debe cumplir (checks). Constaia devuelve un veredicto:

EstadoSignificado
VálidoEs del tipo esperado y todas las comprobaciones pasan.
No válidoEs de otro tipo o falla una comprobación crítica: caducado, titular distinto, letra del NIF incorrecta…
RevisarConfianza baja, mala calidad de imagen o señales dudosas. Debe mirarlo una persona.

Cada veredicto va acompañado de motivos (reasons) con un código estable para tu lógica y un mensaje traducido para mostrar al usuario:

"verdict": {
  "expected": ["es_dni"],
  "match": true,
  "status": "valid",
  "reasons": [
    { "code": "type_match", "severity": "info", "message": "El documento es un DNI español." },
    { "code": "not_expired", "severity": "info", "message": "Vigente hasta el 12/03/2031." }
  ]
}

Además del veredicto, cada análisis devuelve:

  • Tipo de documento detectado, con su confianza (document).
  • Campos extraídos con confianza por campo y la posición en la página de la que salen (fields).
  • Comprobaciones deterministas hechas en código, no por la IA: letra del NIF/NIE, dígitos de control de la MRZ, coherencia entre la MRZ y los datos impresos, IBAN, fechas (checks).
  • Avisos sobre la imagen o el documento: desenfoque, recorte, reflejos, posible foto de pantalla (warnings).
  • Exportaciones en JSON, CSV, XLSX, XML, vCard o PDF.

Qué no es Constaia

Límites del producto

  • No es KYC biométrico. No compara selfies con la foto del documento ni hace prueba de vida.
  • No prueba que un documento sea auténtico. Un checksum correcto indica que los datos son coherentes, no que el documento no haya sido falsificado. Los warnings como edited_suspected o screen_photo_suspected son indicios, no garantías.
  • No sustituye tu criterio. El veredicto review existe para que una persona decida en los casos dudosos.

Europea y con retención cero por defecto

  • Todo el procesamiento ocurre en la UE: servidores en Hetzner, OCR de Mistral y modelos en AWS Bedrock eu-central-1.
  • Por defecto storage es "none": el fichero se borra en cuanto termina el análisis.
  • Con keep_results: false tampoco se guardan los campos extraídos; solo queda lo necesario para facturar.
  • Si lo necesitas, puedes pedir almacenamiento temporal o persistente, cifrado por cuenta.

Más detalle en Almacenamiento y privacidad.

Por dónde empezar

Empieza en 5 minutos

Crea una cuenta gratis, copia tu clave de test y haz tu primera llamada.

POST /v1/analyze

El endpoint principal: veredicto, campos, comprobaciones y exportaciones.

Catálogo de documentos

DNI, NIE, pasaporte, certificados médicos, justificantes de pago, facturas y más.

SDKs

JavaScript/TypeScript y PHP (con integración para Laravel).

Webhooks

Recibe los análisis asíncronos y los lotes firmados con Standard Webhooks.

Veredictos

Cómo leer valid, invalid y review, y qué hacer con cada uno.

Empieza en 5 minutos

Crea una cuenta gratis, copia tu clave de test y valida tu primer DNI con curl, JavaScript o PHP en menos de cinco minutos.

En esta página

La pregunta que respondeQué no es ConstaiaEuropea y con retención cero por defectoPor dónde empezar