co_cedula_digital

Cédula digital (Colombia)

Cédula de ciudadanía digital colombiana (desde 2020), tarjeta de policarbonato con QR y MRZ TD1.

Categoría: Identidad
País: Colombia
Campos que extrae: 13 campos
Coste: 1 crédito

co_cedula_digitalspecimen

Número de documento
Nombre
Apellidos
Sexo
Nacionalidad
Fecha de nacimiento
Fecha de expedición
Fecha de caducidad
País emisor

Qué comprueba

MRZ ICAO 9303. Dígitos de control de la zona de lectura mecánica.
MRZ frente a lo impreso. La MRZ coincide con los datos visibles.
Identificadores nacionales. Checksum o formato oficial del número (NIF, CPF, CURP, RUT, codice fiscale…).co_cedula
Titular. Nombre, número o fecha de nacimiento coinciden con lo esperado.
Edad. Edad mínima o máxima calculada con la fecha de nacimiento.
Vigencia. No caducado en la fecha de referencia.

Campos que extrae

Número de documentodocument_number
Nombrefirst_name
Apellidoslast_name
Sexosex
Nacionalidadnationality
Fecha de nacimientobirth_date
Fecha de expediciónissue_date
Fecha de caducidadexpiry_date
País emisorissuing_country
Mrzmrz
Lugar de nacimientobirth_place
Issue placeissue_place
Blood typeblood_type

Petición de ejemplo

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

Ejemplo de respuesta

Datos ficticios. Respuesta abreviada.

200 OK · application/json

{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "co_cedula_digital",
    "label": "Cédula digital (Colombia)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "co_cedula_digital"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Cédula digital (Colombia)."
      }
    ]
  },
  "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": "Los dígitos de control de la MRZ son correctos."
    },
    {
      "code": "mrz_matches_visual",
      "passed": true,
      "message": "La MRZ coincide con los datos impresos."
    },
    {
      "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

¿Constaia prueba que el documento es auténtico?

No. Comprueba el tipo, la coherencia de los datos y tus reglas, y avisa de señales como posible edición o foto de pantalla. Eso no prueba autenticidad.

¿Se guarda una copia del documento?

No, salvo que lo pidas. Con storage "none" (por defecto) el fichero se borra al terminar el análisis.

Otros documentos

Y para que conste…

Crea tu cuenta, copia la clave de test y valida tu primer documento en cinco minutos.

Crear cuenta gratis Hablar con ventas