Short answer: To verify a Colombian ID with Verifik's API, send GET /v2/co/cedula with documentType (CC or PPT), the number and your Bearer token. You get the full name and a timestamped signature. To confirm the ID is valid at the Registraduría, use the certificate lookup with the issue date. Updated: November 2026.

Colombia ID verification API: endpoint, code and response

The lookup uses GET https://api.verifik.co/v2/co/cedula with Authorization: Bearer authentication. The full reference is in the Colombia identity documentation.

cURL example

curl -G "https://api.verifik.co/v2/co/cedula" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $VERIFIK_TOKEN" \
  --data-urlencode "documentType=CC" \
  --data-urlencode "documentNumber=123456789"

JavaScript example

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/cedula", {
  params: { documentType: "CC", documentNumber: "123456789" },
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
  },
});

console.log(data.data.fullName);

Sample response

{
  "data": {
    "arrayName": [
      "JUAN",
      "CARLOS",
      "PEREZ",
      "GOMEZ"
    ],
    "documentNumber": "123456789",
    "documentType": "CC",
    "firstName": "JUAN CARLOS",
    "fullName": "JUAN CARLOS PEREZ GOMEZ",
    "lastName": "PEREZ GOMEZ"
  },
  "signature": {
    "dateTime": "November 3, 2026 9:15 AM",
    "message": "Certified by Verifik.co"
  },
  "id": "CC01A"
}

Registraduría validity check and certificate

With GET /v2/co/registraduria/certificado you send the number and the issue date (DD/MM/YYYY). The novedad field shows the status (for example, VIGENTE) and pdfBase64 carries the certificate (documentation).

import os, requests

url = "https://api.verifik.co/v2/co/registraduria/certificado"
headers = {
    "Accept": "application/json",
    "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"
}
params = {"documentNumber": "123456789", "date": "10/10/2020"}

r = requests.get(url, headers=headers, params=params)
print(r.status_code, r.json())

{
  "data": {
    "codigoVerificacion": "ABC123XYZ",
    "novedad": "VIGENTE",
    "pdfBase64": "JVBERi0xLjQK...",
    "documento": {
      "cedula": "123456789",
      "fechaExpedicion": "10/10/2020",
      "lugarExpedicion": "BOGOTA D.C.",
      "nombre": "JUAN CARLOS PEREZ GOMEZ"
    }
  },
  "signature": {
    "dateTime": "November 3, 2026 9:16 AM",
    "message": "Certified by Verifik.co"
  }
}

Response codes

{
  "code": "MissingParameter",
  "message": "documentType must be one of: [CC,PPT]"
}

Next step: background checks and full KYC

After the cédula you can check Colombian police records by API, verify a foreigner ID (cédula de extranjería) or read our cédula de ciudadanía verification guide. The full flow (cédula, biometrics, background records and PEP) is in our Colombia KYC API guide. If you operate in telecoms, finance or credit, check what Law 2573 of 2026 requires.

Frequently asked questions

What does the ID verification return? Full name, first and last names, document type and number, a timestamped signature and a lookup id.

Does it also verify the Temporary Protection Permit? Yes. Send documentType=PPT to the same endpoint.

How do I know whether the cédula is valid? With the Registraduría certificate (/v2/co/registraduria/certificado), which returns the status in novedad.

What authentication does the API use? A token in the Authorization: Bearer header, which you get when you create your Verifik account.