eu_residence_permit

Permiso de residencia UE (modelo uniforme)

Tarjeta de residencia para nacionales de terceros países con el modelo uniforme del Reglamento (CE) 1030/2002 (MRZ TD1), expedida por cualquier Estado de la UE/EEE o Suiza.

Categoría: Residencia
País: Unión Europea
Campos que extrae: 15 campos
Coste: 1 crédito

eu_residence_permitspecimen

Número de documento
Nombre
Apellidos
Sexo
Nacionalidad
Fecha de nacimiento
Fecha de expedición
Fecha de caducidad
País emisor

Qué comprueba

MRZ ICAO 9303. Dígitos de control de la zona de lectura mecánica.
MRZ frente a lo impreso. La MRZ coincide con los datos visibles.
Titular. Nombre, número o fecha de nacimiento coinciden con lo esperado.
Edad. Edad mínima o máxima calculada con la fecha de nacimiento.
Vigencia. No caducado en la fecha de referencia.

Campos que extrae

Número de documentodocument_number
Nombrefirst_name
Apellidoslast_name
Sexosex
Nacionalidadnationality
Fecha de nacimientobirth_date
Fecha de expediciónissue_date
Fecha de caducidadexpiry_date
País emisorissuing_country
Mrzmrz
Tipo de permisopermit_type
Remarksremarks
Lugar de nacimientobirth_place
Domicilioaddress
Personal numberpersonal_number

Petición de ejemplo

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "eu_residence_permit",
    "checks": {
      "not_expired": true,
      "holder": {
        "full_name": "Carmen Especimen Ruiz"
      }
    },
    "storage": "none"
  }'

Ejemplo de respuesta

Datos ficticios. Respuesta abreviada.

200 OK · application/json

{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "eu_residence_permit",
    "label": "Permiso de residencia UE (modelo uniforme)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "eu_residence_permit"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Permiso de residencia UE (modelo uniforme)."
      }
    ]
  },
  "fields": {
    "document_number": {
      "value": "X01234567",
      "confidence": 0.99,
      "validated": true
    },
    "first_name": {
      "value": "AMINA",
      "confidence": 0.98,
      "validated": null
    },
    "last_name": {
      "value": "SPECIMEN",
      "confidence": 0.97,
      "validated": null
    },
    "sex": {
      "value": "F",
      "confidence": 0.96,
      "validated": null
    },
    "nationality": {
      "value": "SEN",
      "confidence": 0.99,
      "validated": null
    },
    "birth_date": {
      "value": "1990-02-11",
      "confidence": 0.98,
      "validated": null
    },
    "issue_date": {
      "value": "2024-05-20",
      "confidence": 0.97,
      "validated": null
    },
    "expiry_date": {
      "value": "2029-05-19",
      "confidence": 0.96,
      "validated": null
    },
    "issuing_country": {
      "value": "DEU",
      "confidence": 0.99,
      "validated": null
    },
    "mrz": {
      "value": "ARD<<X012345679<<<<<<<<<<<<<<<\n9002111F2905198SEN<<<<<<<<<<<8\nSPECIMEN<<AMINA<<<<<<<<<<<<<<<",
      "confidence": 0.98,
      "validated": null
    },
    "permit_type": {
      "value": "Aufenthaltserlaubnis",
      "confidence": 0.97,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "mrz_checksums",
      "passed": true,
      "message": "Los dígitos de control de la MRZ son correctos."
    },
    {
      "code": "mrz_matches_visual",
      "passed": true,
      "message": "La MRZ coincide con los datos impresos."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

¿Constaia prueba que el documento es auténtico?

No. Comprueba el tipo, la coherencia de los datos y tus reglas, y avisa de señales como posible edición o foto de pantalla. Eso no prueba autenticidad.

¿Se guarda una copia del documento?

No, salvo que lo pidas. Con storage "none" (por defecto) el fichero se borra al terminar el análisis.

Otros documentos

Y para que conste…

Crea tu cuenta, copia la clave de test y valida tu primer documento en cinco minutos.

Crear cuenta gratis Hablar con ventas