Colombian Citizen

Endpoint

GET https://api.verifik.co/v2/co/cedula

Same path on the app host: GET https://verifik.app/v2/co/cedula.

The route also accepts POST with the same fields in the body (for clients that prefer it).

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Document requirements

Who is this for? Anyone whose name can be resolved from official Colombian sources. /v2/co/cedula consolidates Procuraduría, DIAN, ADRES, and Registraduría. CE, PEP, and NIT typically resolve through Procuraduría.

Type	Who holds it	documentType	Typical length in Colombia	This API accepts
CC	Colombian citizens	CC	3–10 digits (common: 8 or 10 NUIP)	5–10 digits, digits only
CE	Foreign residents (name lookup)	CE	Usually 6–7 digits	5–10 digits, digits only
PPT	Venezuelan migrants (name lookup on this path)	PPT	Up to 7 digits	5–10 digits, digits only
PEP	Permiso Especial de Permanencia (name lookup)	PEP	Typically 7–10 digits on this path	5–10 digits, digits only
NIT	Tax ID (person or company name)	NIT	9–10 digits	5–10 digits, digits only

How to enter documentNumber: digits only — no dots, spaces, or dashes. Example CC: 1032386359.

Use a different endpoint for:

• Procuraduría names only → Colombia Procuraduría (/v2/co/procuraduria)
• CE immigration status (expiration) → Colombia CE (/v2/co/foreigner-id/ce + expeditionDate)
• PPT immigration status (VIGENTE / expiration) → Colombia PPT (/v2/co/foreigner-id/ppt + expeditionDate)
• PEP immigration status (15-digit Migración number) → Colombia PEP

Full comparison: Colombia identity documents guide.

Parameters

Name	Type	Required	Description
documentType	string	Yes	One of CC, CE, PPT, NIT, PEP. See the documents guide.
documentNumber	string	Yes	Document number, digits only (no spaces or periods). 5–10 characters (API validation). CC is commonly 8 or 10 digits; PPT is often up to 7 digits in official records. Example: 1032386359.

Dynamic pricing

This endpoint participates in Verifik's Dynamic Query architecture. In most cases you pay the standard rate for /v2/co/cedula. When standard verification paths do not return a match, an extended verification path may run automatically. If that path returns HTTP 200, dynamic pricing applies and credits are deducted at the premium tier for this endpoint family—not the standard tier.

Price expectation: From your account's standard rate · up to premium rate (see your plan, Postman, or the client panel).

flowchart LR
  client[Client calls /v2/co/cedula]
  standardPath[Standard verification paths]
  extendedPath[Extended verification path]
  chargeStandard[Charge standard rate]
  chargePremium[Charge premium rate — dynamic pricing]

  client --> standardPath
  standardPath -->|"Match HTTP 200"| chargeStandard
  standardPath -->|"No match"| extendedPath
  extendedPath -->|"Match HTTP 200"| chargePremium
  extendedPath -->|"No match HTTP 404"| chargeStandard

Optional billing transparency: pass query parameter includeCost=true on your request. When credits are charged, the response may include a billing object when dynamic pricing applies:

"billing": {
  "dynamicQueryApplied": true,
  "adjustmentType": "dynamic_query_premium",
  "standardCredits": 0.3,
  "chargedCredits": 2,
  "standardFeatureCode": "colombia_api_identity_lookup",
  "billedFeatureCode": "colombia_api_identity_lookup_premium"
}

Credit amounts are illustrative; actual values depend on your plan.

• SLA: Dynamic pricing (billing)
• Direct premium route: Contact Verifik support for the explicit premium route documentation. It always uses premium pricing.

Request

Node.js

import axios from "axios";

const options = {
	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}`,
	},
};

const { data } = await axios.request(options);
console.log(data);

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)
print(r.json())

Response

200

{
	"data": {
		"documentType": "CC",
		"documentNumber": "123456789",
		"firstName": "Juan",
		"lastName": "Pérez",
		"fullName": "Juan Pérez"
	},
	"signature": {
		"message": "Certified by Verifik.co",
		"dateTime": "January 16, 2024 3:44 PM"
	},
	"id": "AB123"
}

404

{
	"message": "Document not found",
	"code": "DOCUMENT_NOT_FOUND"
}

401

{
	"message": "Authentication required",
	"code": "UNAUTHORIZED"
}

Notes

• Use documentType=CC, CE, PPT, NIT, or PEP. CE, PEP, and NIT names typically come from Procuraduría. For immigration status (expiration / VIGENTE) use the dedicated foreigner-id routes.
• For Procuraduría names only (no DIAN / ADRES / Registraduría), call Colombia Procuraduría (/v2/co/procuraduria).
• See the Colombia identity documents guide for digit-length details and endpoint routing.

---

Identity Verification in Colombia

Verifik's Identity Verification API helps you authenticate Colombian citizens using official government data. It's designed to streamline your KYC (Know Your Customer) processes, prevent fraud, and ensure you meet all regulatory requirements effortlessly.

We built this integration for businesses that need a fast, secure, and automated way to confirm the true identity of users, employees, or customers.

What does this API validate?

Our API connects directly with official records to validate:

• Full name & ID number: Cédula de Ciudadanía (CC), Cédula de Extranjería (CE), Permiso por Protección Temporal (PPT), Permiso Especial de Permanencia (PEP), and NIT. Dedicated Colombia CE remains available when you need expedition date / immigration status.
• Document status: Checks status against official civil-registry and related sources used for this integration.
• Identity match: Confirms that returned identity data corresponds to the document number queried.

By verifying these details, you can be confident that the person you're dealing with is real and holds a valid document, significantly lowering the risk of impersonation and fraud.

Common Use Cases

• Fintech & Banking: Verify identities instantly during account opening or loan applications.
• E-commerce & Delivery: Authenticate users and couriers before they become active on your platform.
• HR & Recruitment: Validate candidate documents as part of your hiring workflow.
• Insurance & Healthcare: Confirm identities before issuing policies or providing medical benefits.

Official Sources & Reliability

We connect directly with Colombia's Registraduría Nacional del Estado Civil to ensure you receive verified, up-to-the-minute information. Every query is handled with strict adherence to security and regulatory standards, including:

• Law 1581 of 2012 (Personal Data Protection)
• KYC/AML Circulars from the UIAF and Financial Superintendence of Colombia

Key Benefits

• Automated Compliance: Streamline your KYC checks to prevent fraud without adding friction for your users.
• Instant Results: Process verifications in seconds, perfect for real-time digital onboarding.
• Trusted Data: Rely on data sourced directly from the Colombian government.
• Easy Integration: Connect easily via our REST API or use our compatible SDKs.

Compliance & Security

We prioritize the safety of your data. Verifik uses advanced encryption (HTTPS/TLS 1.3) and strict privacy management standards to ensure confidentiality. Our service is monitored 24/7 for availability and offers role-based access controls to keep your team's access secure.

About Verifik

Verifik is a leading platform for identity verification, compliance, and fraud prevention across Latin America. Our APIs automate KYC, KYB, AML, and biometric validation processes, connecting businesses with official data sources in Colombia, Mexico, Peru, Chile, Uruguay, and beyond.

Related APIs

Explore other verification services in the Colombian ecosystem:

• INPEC Background Check: Verify criminal records and judicial history.
• SIGEP Public Servant Verification: Validate public employment status.
• RUNT Vehicle Validation: Check vehicle history and ownership.

Frequently Asked Questions (FAQ)

Is this API compliant with Colombian data protection laws?

Yes, Verifik complies with Law 1581 of 2012 (Habeas Data) and adheres to KYC/AML regulations set by the UIAF and Financial Superintendence. We ensure all data is processed securely and with proper authorization.

What document types can be verified?

The API supports Cédula de Ciudadanía (CC) for Colombian citizens and Permiso por Protección Temporal (PPT) for Venezuelan migrants.

Is the data retrieved in real-time?

Yes, our API connects directly to official government sources to provide real-time and up-to-date information, ensuring you always have the latest status of an identity.