Saltar al contenido
Constaia
co_cedula

Cédula de ciudadanía (Colombia)

Cédula de ciudadanía colombiana amarilla con hologramas (Registraduría Nacional), sin fecha de vencimiento; reverso con huella y código de barras PDF417.

Categoría
Identidad
País
Colombia
Campos que extrae
11 campos
Coste
1 crédito
co_cedulaspecimen
Número de documento
Nombre
Apellidos
Sexo
Nacionalidad
Fecha de nacimiento
Fecha de expedición
Lugar de nacimiento
Issue place

Qué comprueba

  • 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.

Campos que extrae

  • Número de documentodocument_number
  • Nombrefirst_name
  • Apellidoslast_name
  • Sexosex
  • Nacionalidadnationality
  • Fecha de nacimientobirth_date
  • Fecha de expediciónissue_date
  • Lugar de nacimientobirth_place
  • Issue placeissue_place
  • Heightheight
  • 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",
    "checks": {
      "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",
    "label": "Cédula de ciudadanía (Colombia)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "co_cedula"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Cédula de ciudadanía (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": "2013-08-15",
      "confidence": 0.97,
      "validated": null
    },
    "birth_place": {
      "value": "BOGOTA D.C. (CUNDINAMARCA)",
      "confidence": 0.96,
      "validated": null
    },
    "issue_place": {
      "value": "BOGOTA D.C.",
      "confidence": 0.99,
      "validated": null
    },
    "height": {
      "value": "1.65",
      "confidence": 0.98,
      "validated": null
    },
    "blood_type": {
      "value": "O+",
      "confidence": 0.97,
      "validated": null
    }
  },
  "checks": [
    {
      "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.