passportPassport (any country)
Read and validate the machine-readable zone of passports from any country under ICAO 9303.
- Category
- Identity
- Country
- International
- Fields it extracts
- 10 fields
- Cost
- 1 credit
passportspecimen- Document number
- First name
- Last name
- Sex
- Nationality
- Date of birth
- Issue date
- Expiration date
- Issuing country
Every passport follows ICAO 9303. Constaia validates the check digits of the machine-readable zone, compares them with the data page and checks the expiration date and the holder's age.
- The data page is enough: 1 credit.
- Set a minimum age and the date of your event to check age groups.
What it checks
- MRZ ICAO 9303. Check digits of the machine readable zone.
- MRZ vs printed data. The MRZ matches the visible data.
- Validity. Not expired on the reference date.
- Holder. Name, number or date of birth match what you expect.
- Age. Minimum or maximum age from the date of birth.
Fields it extracts
- Document number
document_number - First name
first_name - Last name
last_name - Sex
sex - Nationality
nationality - Date of birth
birth_date - Issue date
issue_date - Expiration date
expiry_date - Issuing country
issuing_country - Mrz
mrz
Where it is used
Sample request
curl https://api.constaia.com/v1/analyze \
-H "Authorization: Bearer $CONSTAIA_API_KEY" \
-F "file=@passport.jpg" \
-F 'options={
"expect": "passport",
"checks": {
"not_expired": true,
"min_age_years": 18
},
"storage": "none"
}'Try it for free in test mode with the file passport.jpg.
Sample response
Fictitious data. Shortened response.
{
"id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
"object": "analysis",
"status": "completed",
"livemode": false,
"document": {
"type": "passport",
"label": "Passport (any country)",
"confidence": 0.97
},
"verdict": {
"expected": [
"passport"
],
"match": true,
"status": "valid",
"reasons": [
{
"code": "type_match",
"severity": "info",
"message": "The document is: Passport (any country)."
}
]
},
"fields": {
"document_number": {
"value": "PAA123456",
"confidence": 0.99,
"validated": true
},
"names": {
"value": "JOHN SMITH",
"confidence": 0.98,
"validated": null
},
"nationality": {
"value": "GBR",
"confidence": 0.97,
"validated": null
},
"birth_date": {
"value": "1985-07-21",
"confidence": 0.96,
"validated": null
},
"expiry_date": {
"value": "2032-01-15",
"confidence": 0.99,
"validated": null
},
"issuing_country": {
"value": "GBR",
"confidence": 0.98,
"validated": null
},
"sex": {
"value": "M",
"confidence": 0.97,
"validated": null
}
},
"checks": [
{
"code": "mrz_checksums",
"passed": true,
"message": "The MRZ check digits are correct."
},
{
"code": "mrz_matches_visual",
"passed": true,
"message": "The MRZ matches the printed data."
}
],
"warnings": [],
"storage": {
"mode": "none",
"file_deleted_at": "2026-09-29T10:00:02Z",
"expires_at": null
},
"usage": {
"credits": 1,
"pages": 1
}
}FAQ
Does Constaia prove that the document is authentic?
No. It checks the type, the consistency of the data and your rules, and flags signals such as a possible edit or a photo of a screen. That does not prove authenticity.
Is a copy of the document kept?
Only if it needs review: then it's kept encrypted until someone decides and for 24 hours after that (configurable). Otherwise it's deleted as soon as the analysis ends. You can choose never to keep it.
Other documents
And for the record…
Create your free account and validate your first document in five minutes. No credit card required.