Aller au contenu
Constaia
eu_residence_permit

Titre de séjour UE (modèle uniforme)

Carte de séjour pour ressortissants de pays tiers au modèle uniforme du règlement (CE) 1030/2002 (MRZ TD1), délivrée par tout État de l'UE/EEE ou la Suisse.

Catégorie
Séjour
Pays
Union européenne
Champs extraits
15 champs
Coût
1 crédit
eu_residence_permitspecimen
Numéro du document
Prénom
Nom
Sexe
Nationalité
Date de naissance
Date de délivrance
Date d'expiration
Pays de délivrance

Ce qui est contrôlé

  • MRZ OACI 9303. Chiffres de contrôle de la zone de lecture automatique.
  • MRZ et données imprimées. La MRZ correspond aux données visibles.
  • Titulaire. Nom, numéro ou date de naissance correspondent à l'attendu.
  • Âge. Âge minimum ou maximum à partir de la date de naissance.
  • Validité. Non expiré à la date de référence.

Champs extraits

  • Numéro du documentdocument_number
  • Prénomfirst_name
  • Nomlast_name
  • Sexesex
  • Nationaliténationality
  • Date de naissancebirth_date
  • Date de délivranceissue_date
  • Date d'expirationexpiry_date
  • Pays de délivranceissuing_country
  • Mrzmrz
  • Type d'autorisationpermit_type
  • Remarksremarks
  • Lieu de naissancebirth_place
  • Adresseaddress
  • Personal numberpersonal_number

Exemple de requête

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"
  }'

Exemple de réponse

Données fictives. Réponse abrégée.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "eu_residence_permit",
    "label": "Titre de séjour UE (modèle uniforme)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "eu_residence_permit"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "Le document est : Titre de séjour UE (modèle 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": "Les chiffres de contrôle de la MRZ sont corrects."
    },
    {
      "code": "mrz_matches_visual",
      "passed": true,
      "message": "La MRZ correspond aux données imprimées."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

Constaia prouve-t-il que le document est authentique ?

Non. Il contrôle le type, la cohérence des données et vos règles, et signale des indices comme une possible retouche ou une photo d'écran. Cela ne prouve pas l'authenticité.

Une copie du document est-elle conservée ?

Non, sauf si vous le demandez. Avec storage "none" (par défaut), le fichier est supprimé à la fin de l'analyse.

Autres documents

Et pour valoir ce que de droit…

Créez votre compte, copiez la clé de test et validez votre premier document en cinq minutes.