co_cedula_digitalColombian digital ID card (cédula digital)
Colombian digital citizenship card (since 2020), polycarbonate card with QR code and TD1 MRZ.
- Category
- Identity
- Country
- Colombia
- Extracted fields
- 13 fields
- Cost
- 1 credit
co_cedula_digitalspecimen- Document number
- First name
- Last name
- Sex
- Nationality
- Date of birth
- Issue date
- Expiry date
- Issuing country
What it checks
- MRZ ICAO 9303. Check digits of the machine readable zone.
- MRZ vs printed data. The MRZ matches the visible data.
- National identifiers. Official checksum or format of the number (NIF, CPF, CURP, RUT, SSN…).
co_cedula - 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.
Extracted fields
- 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 - Expiry date
expiry_date - Issuing country
issuing_country - Mrz
mrz - Place of birth
birth_place - Issue place
issue_place - Blood type
blood_type
Sample request
curl https://api.constaia.com/v1/analyze \
-H "Authorization: Bearer $CONSTAIA_API_KEY" \
-F "file=@document.pdf" \
-F 'options={
"expect": "co_cedula_digital",
"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": "co_cedula_digital",
"label": "Colombian digital ID card (cédula digital)",
"confidence": 0.97
},
"verdict": {
"expected": [
"co_cedula_digital"
],
"match": true,
"status": "valid",
"reasons": [
{
"code": "type_match",
"severity": "info",
"message": "The document is: Colombian digital ID card (cédula digital)."
}
]
},
"fields": {
"document_number": {
"value": "1020304050",
"confidence": 0.99,
"validated": true
},
"first_name": {
"value": "MARIA CAMILA",
"confidence": 0.98,
"validated": null
},
"last_name": {
"value": "ESPECIMEN GOMEZ",
"confidence": 0.97,
"validated": null
},
"sex": {
"value": "F",
"confidence": 0.96,
"validated": null
},
"nationality": {
"value": "COL",
"confidence": 0.99,
"validated": null
},
"birth_date": {
"value": "1995-07-30",
"confidence": 0.98,
"validated": null
},
"issue_date": {
"value": "2022-03-01",
"confidence": 0.97,
"validated": null
},
"expiry_date": {
"value": "2032-03-01",
"confidence": 0.96,
"validated": null
},
"issuing_country": {
"value": "COL",
"confidence": 0.99,
"validated": null
},
"mrz": {
"value": "ICCOL1020304051<<<<<<<<<<<<<<<\n9507306F3203019COL<<<<<<<<<<<4\nESPECIMEN<GOMEZ<<MARIA<CAMILA<",
"confidence": 0.98,
"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."
},
{
"code": "id_number",
"passed": true,
"message": "id_number"
}
],
"warnings": [],
"storage": {
"mode": "none",
"file_deleted_at": "2026-09-29T10:00:02Z",
"expires_at": null
},
"usage": {
"credits": 1,
"pages": 1
}
}FAQ
Does Constaia prove the document is authentic?
No. It checks the type, data consistency and your rules, and flags signals such as a possible edit or a screen photo. That does not prove authenticity.
Is a copy of the document kept?
No, unless you ask for it. With storage "none" (the default) the file is deleted when the analysis ends.
Other documents
And for the record…
Create your account, copy the test key and validate your first document in five minutes.