Colombia ID Verification API: Cédula (CC) Check in Real Time

Validate Colombian national identity cards in real time with access to official sources. API for identity verification, KYC compliance, and fraud prevention.

The Citizen ID (CC) proves a person's identity with an official and reliable level.

Colombia is the only country that offers this type of document to identify its citizens.

Each country assigns a different name to the Identity Document, with its own design, but all share key data to identify a person.

Explore Documentation by Country

Verifik makes it easy to verify identity documents so that your KYC is the same in any country or format.

What does Verifik offer?

High precision OCR

We automatically extract the visible data from the document.

Contrast with Official Sources

Automate and verify information in real time.

Document analysis (AI)

We detect edits, montages, manipulated or inconsistent documents.

Facial comparison + Liveness

Biometric confirmation to ensure the person is real.

API integration

Ideal for companies that require mass onboarding or validation flows.

Financial decisions

Hiring processes

Shipments, deliveries or reservations

User logs

Regulatory compliance KYC/AML

Why is it important to validate these documents?

We help the best companies to properly validate their customers to improve their business line.

Verifik reduces risks and accelerates v verification in industries such as fintech, insurance, mobility, e-commerce and more.

Updated: November 14, 2026 · checked against the official API documentation.

Short answer: To verify a Colombian ID by API, send GET /v2/co/cedula with documentType (CC or PPT), the number without dots and your Bearer token. Verifik checks the Registraduría and returns the holder's full name with a timestamped signature. To confirm the ID is still valid, use the Registraduría certificate lookup with the issue date.

Colombia ID verification API: what it checks in 2026

Verifik's cédula endpoint queries Colombia's Registraduría Nacional del Estado Civil and confirms that the number exists and whose name it belongs to. It supports two documents: the citizenship card (cédula de ciudadanía, CC) and the Temporary Protection Permit (PPT) issued to Venezuelan migrants. It does not cover the foreigner ID card, which has its own endpoint (see our guide to verifying Colombian foreigner IDs), or company NITs.

With the response you can match the name your user typed against the registered one, block non-existent numbers before an account is opened and keep a lookup ID as evidence for your KYC audit trail.

Colombia ID verification API endpoint and parameters

The route is GET https://api.verifik.co/v2/co/cedula (POST with the same fields also works). You authenticate with the Authorization: Bearer <token> header and ask for JSON with Accept: application/json.

ParameterTypeRequiredDescription
documentTypestringYesCC or PPT (not NIT)
documentNumberstringYes5 to 10 characters, no spaces or dots

Colombia ID verification API code examples

All three examples run the same lookup. Swap the test number for your user's and keep the token in an environment variable, never in client-side code.

cURL

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"

Node.js

import axios from "axios";

const { data } = await axios.request({
  method: "GET",
  url: "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, data.id);

Python

import os, requests

url = "https://api.verifik.co/v2/co/cedula"
headers = {
    "Accept": "application/json",
    "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}",
}
params = {"documentType": "CC", "documentNumber": "123456789"}
r = requests.get(url, headers=headers, params=params, timeout=30)
print(r.status_code, r.json())

Sample Colombia ID verification response and fields

A successful lookup returns HTTP 200 with the holder's names, the document you queried and a Verifik signature. The data below is fictitious.

{
  "data": {
    "arrayName": [
      "JUAN",
      "CARLOS",
      "PEREZ",
      "GOMEZ"
    ],
    "documentNumber": "123456789",
    "documentType": "CC",
    "firstName": "JUAN CARLOS",
    "fullName": "JUAN CARLOS PEREZ GOMEZ",
    "lastName": "PEREZ GOMEZ"
  },
  "signature": {
    "dateTime": "November 14, 2026 9:15 AM",
    "message": "Certified by Verifik.co"
  },
  "id": "CC01A"
}
FieldWhat it holds
fullNameHolder's full name
firstName / lastNameGiven names and surnames
arrayNameEach name as an item in a list
documentType / documentNumberThe document you queried
signatureDate and time of the lookup with the message “Certified by Verifik.co”
idLookup ID for your audit trail

Colombia ID verification API error codes

These are the cases the documentation lists. None of them should become an automatic rejection without review: a 404 can simply be a mistyped number.

CodeResponseWhat to do
200Successful lookupMatch the name and store id and signature
404NotFound: “Record not found.”Ask the user to check the number and document type
409MissingParameter: “missing documentType” or “missing documentNumber”Send both parameters
409MissingParameter: “documentType must be one of: [CC,PPT]”Use CC or PPT; foreigner IDs use their own endpoint
{
  "code": "NotFound",
  "message": "Record not found."
}
{
  "code": "MissingParameter",
  "message": "documentType must be one of: [CC,PPT]"
}

Check Colombian ID validity with the Registraduría certificate API

If you also need to know whether the cédula is currently valid, GET /v2/co/registraduria/certificado takes the number and the issue date (not the date of birth) in DD/MM/YYYY format. It returns the status in novedad (for example, VIGENTE), a verification code and the certificate as a base64-encoded PDF (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"}  # issue date, DD/MM/YYYY
r = requests.get(url, headers=headers, params=params, timeout=60)
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 14, 2026 9:16 AM",
    "message": "Certified by Verifik.co"
  }
}

If the date is not in DD/MM/YYYY, the API answers 409 MissingParameter. When the source is temporarily unavailable it may answer 409 with Endpoint_out_of_service: retry later instead of rejecting the user. Treat the PDF and personal fields as sensitive data.

How to use Colombia ID verification in onboarding

  1. Ask for the document type and number in your sign-up form.
  2. Call /v2/co/cedula and compare fullName with the name the user entered.
  3. If you have the issue date, confirm validity with the Registraduría certificate.
  4. To know the person signing up is the holder, add a selfie with liveness detection and a face match against the ID.
  5. Depending on your risk, run a Colombian police record check by API and watchlist screening.
  6. Store the id and signature of every response in the customer file.

The full Colombia KYC flow, with every endpoint, is in our Colombia KYC API guide, and the new anti-impersonation duties are summarised on our Law 2573 of 2026 page. For a no-code explanation, read our cédula de ciudadanía verification guide.

Ready to try it? Create your free Verifik account, generate your token and run your first Colombian ID check from your code.

Frequently Asked Questions (FAQs)

➖

What does the Colombia ID verification API return?

The holder's full name, given names and surnames separately, the document type and number, a Verifik signature with date and time, and a lookup ID you can keep as evidence.

➕

Which documents does the /v2/co/cedula endpoint accept?

The citizenship card (CC) and the Temporary Protection Permit (PPT). The foreigner ID card has its own endpoint, and company NITs are not looked up on this route.

➕

How do I know whether a Colombian ID is still valid?

With the Registraduría certificate lookup (GET /v2/co/registraduria/certificado). You send the number and the issue date in DD/MM/YYYY and the response returns the status in the novedad field, for example VIGENTE.

➕

What does a 404 error mean when verifying a cédula?

The source found no record for that number (NotFound, “Record not found.”). It is usually a mistyped number or the wrong document type, so ask the user to check it before rejecting them.

➕

What authentication does the Verifik API use?

A token in the Authorization: Bearer header. You generate it when you create your Verifik account, and it should stay on your server, never in browser or app code.

➕

Does ID verification confirm that the person signing up is the holder?

Not on its own: it confirms that the number exists and whose name it belongs to. To know the person is the holder, combine it with a selfie, liveness detection and a face match against the ID.

➕

How does Verifik handle personal data in these lookups?

According to its documentation, Verifik processes data under Colombia's Law 1581 of 2012 on personal data protection. Your company must have the holder's authorization to look up their information.

Validate identity cards from all over Latin America from a single platform.

Discover how Verifik can automate your processes, reduce fraud and improve your users' experience.