Aller au contenu
Constaia
refugee_travel_document

Titre de voyage pour réfugiés

Titre de voyage de la Convention de 1951 ou pour apatrides (1954), format passeport avec MRZ TD3.

Catégorie
Séjour
Pays
International
Champs extraits
11 champs
Coût
1 crédit
refugee_travel_documentspecimen
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
  • Issuing authorityissuing_authority

Exemple de requête

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "refugee_travel_document",
    "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": "refugee_travel_document",
    "label": "Titre de voyage pour réfugiés",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "refugee_travel_document"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "Le document est : Titre de voyage pour réfugiés."
      }
    ]
  },
  "fields": {
    "document_number": {
      "value": "R12345678",
      "confidence": 0.99,
      "validated": true
    },
    "first_name": {
      "value": "YUSUF",
      "confidence": 0.98,
      "validated": null
    },
    "last_name": {
      "value": "SPECIMEN",
      "confidence": 0.97,
      "validated": null
    },
    "sex": {
      "value": "M",
      "confidence": 0.96,
      "validated": null
    },
    "nationality": {
      "value": "XXA",
      "confidence": 0.99,
      "validated": null
    },
    "birth_date": {
      "value": "1988-06-01",
      "confidence": 0.98,
      "validated": null
    },
    "issue_date": {
      "value": "2025-01-10",
      "confidence": 0.97,
      "validated": null
    },
    "expiry_date": {
      "value": "2030-01-09",
      "confidence": 0.96,
      "validated": null
    },
    "issuing_country": {
      "value": "FRA",
      "confidence": 0.99,
      "validated": null
    },
    "mrz": {
      "value": "PTFRASPECIMEN<<YUSUF<<<<<<<<<<<<<<<<<<<<<<<<\nR123456783XXA8806013M3001097<<<<<<<<<<<<<<<8",
      "confidence": 0.98,
      "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.