Why was I charged more than the listed cédula price?

When standard verification paths on GET/POST /v2/co/cedula do not return a match, Verifik may automatically try an extended verification path through Dynamic Query. If that path returns HTTP 200, dynamic pricing applies and you are charged the premium tier for that endpoint family. Pass includeCost=true to see a billing object on the response, or review your API request history for standard vs. charged amounts.

Colombian Citizen

Q: 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.

Q: What document types can be verified?

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

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? Colombian citizens with a Cédula de Ciudadanía (CC), or Venezuelan migrants with a Permiso de Protección Temporal (PPT) when you need name and identity data from civil-registry sources.

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
PPT	Venezuelan migrants (name lookup on this path)	`PPT`	Up to 7 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:

CE (Cédula de Extranjería) → Colombia CE (/v2/co/foreigner-id/ce + expeditionDate)
PPT immigration status (VIGENTE / expiration) → Colombia PPT (/v2/co/foreigner-id/ppt + expeditionDate)
Immigration PEP (Permiso Especial de Permanencia, 15 digits) → Colombia PEP

Full comparison: Colombia identity documents guide.

Parameters

Name	Type	Required	Description
`documentType`	string	Yes	`CC` (Cédula de Ciudadanía) or `PPT` (Permiso de Protección Temporal). `NIT`, `CE`, and immigration `PEP` are not accepted here — 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: National ID premium lookup (/v2/co/cedula/premium) always uses premium pricing.

Request

Node.js
Python

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);

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

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

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

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

Notes

Use documentType=CC for Colombian national ID (cédula) and PPT for Permiso de Protección Temporal name lookup. Do not use NIT here (business/tax endpoints) or CE / immigration PEP (foreigner-id endpoints).
Some UIs list NIT or CE next to identity checks by mistake; the public validator for /v2/co/cedula only allows CC and PPT.
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) or Permiso por Protección Temporal (PPT) — not Cédula de Extranjería (CE); use the dedicated Colombia CE flow for CE.
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.

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.

Endpoint​

Headers​

Document requirements​

Parameters​

Dynamic pricing​

Request​

Response​

Notes​

Identity Verification in Colombia​

What does this API validate?​

Common Use Cases​

Official Sources & Reliability​

Key Benefits​

Compliance & Security​

About Verifik​

Related APIs​

Frequently Asked Questions (FAQ)​