fr_residence_permit

Titre de séjour (Francia)

Permiso de residencia francés (carte de séjour temporaire, pluriannuelle o carte de résident) con MRZ TD1; indica el tipo, la mención y el número de extranjero (AGDREF).

Categoría: Residencia
País: Francia
Campos que extrae: 15 campos
Coste: 1 crédito

fr_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
Personal numberpersonal_number
Lugar de nacimientobirth_place
Domicilioaddress

Petición de ejemplo

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "fr_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": "fr_residence_permit",
    "label": "Titre de séjour (Francia)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "fr_residence_permit"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Titre de séjour (Francia)."
      }
    ]
  },
  "fields": {
    "document_number": {
      "value": "FR1234567",
      "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": "2028-05-19",
      "confidence": 0.96,
      "validated": null
    },
    "issuing_country": {
      "value": "FRA",
      "confidence": 0.99,
      "validated": null
    },
    "mrz": {
      "value": "IRFRAFR12345674<<<<<<<<<<<<<<<\n9002111F2805195SEN<<<<<<<<<<<8\nSPECIMEN<<AMINA<<<<<<<<<<<<<<<",
      "confidence": 0.98,
      "validated": null
    },
    "permit_type": {
      "value": "Carte de séjour pluriannuelle",
      "confidence": 0.97,
      "validated": null
    },
    "remarks": {
      "value": "Salarié",
      "confidence": 0.96,
      "validated": null
    },
    "personal_number": {
      "value": "7501234567",
      "confidence": 0.99,
      "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