international_driving_permitInternational driving permit
International permit (1949 Geneva or 1968 Vienna Conventions), booklet that accompanies the national licence.
- Category
- Driving licences
- Country
- International
- Fields it extracts
- 9 fields
- Cost
- 1 credit
international_driving_permitspecimen- Document number
- First name
- Last name
- Date of birth
- Issue date
- Expiry date
- Issuing country
- National licence number
- Categories
What it checks
- Holder. Name, number or date of birth match what you expect.
- Age. Minimum or maximum age from the date of birth.
- Validity. Not expired on the reference date.
Fields it extracts
- Document number
document_number - First name
first_name - Last name
last_name - Date of birth
birth_date - Issue date
issue_date - Expiry date
expiry_date - Issuing country
issuing_country - National licence number
national_licence_number - Categories
categories
Where it is used
Sample request
curl https://api.constaia.com/v1/analyze \
-H "Authorization: Bearer $CONSTAIA_API_KEY" \
-F "file=@document.pdf" \
-F 'options={
"expect": "international_driving_permit",
"checks": {
"not_expired": true,
"holder": {
"full_name": "Carmen Especimen Ruiz"
}
},
"storage": "none"
}'Sample response
Fictitious data. Shortened response.
200 OK · application/json
{
"id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
"object": "analysis",
"status": "completed",
"livemode": false,
"document": {
"type": "international_driving_permit",
"label": "International driving permit",
"confidence": 0.97
},
"verdict": {
"expected": [
"international_driving_permit"
],
"match": true,
"status": "valid",
"reasons": [
{
"code": "type_match",
"severity": "info",
"message": "The document is: International driving permit."
}
]
},
"fields": {
"document_number": {
"value": "IDP0123456",
"confidence": 0.99,
"validated": true
},
"first_name": {
"value": "JUAN",
"confidence": 0.98,
"validated": null
},
"last_name": {
"value": "ESPECIMEN",
"confidence": 0.97,
"validated": null
},
"birth_date": {
"value": "1985-07-30",
"confidence": 0.96,
"validated": null
},
"issue_date": {
"value": "2026-01-15",
"confidence": 0.99,
"validated": null
},
"expiry_date": {
"value": "2027-01-14",
"confidence": 0.98,
"validated": null
},
"issuing_country": {
"value": "ESP",
"confidence": 0.97,
"validated": null
},
"national_licence_number": {
"value": "99999999R",
"confidence": 0.96,
"validated": null
},
"categories": {
"value": [
"B"
],
"confidence": 0.99,
"validated": null
}
},
"checks": [],
"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: it is then kept encrypted until someone decides and for 24 hours after that (configurable). Otherwise it is 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 card required.