Colombie — Cédula nationale premium (CC)

Objet : vérifier un numéro de Cédula de Ciudadanía (CC) auprès des sources officielles et renvoyer un dossier d’identité structuré pour les parcours KYC et conformité, et non une simple validation binaire. Le contenu reflète l’état civil tel qu’enregistré, la date de naissance, le lieu et la période de délivrance et, le cas échéant, le sexe et l’indicateur de personne en vie, avec un bloc de certification signé. Seul le numéro est transmis : la date d’expédition est résolue côté serveur (aucun type de document ni de date dans la requête). Niveau de détail équivalent à cédula extra. Coût en crédits supérieur à l’endpoint cédula de base en raison de la chaîne de résolution.

Référence API

Point de terminaison

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

Réponse : retourne data (attributs d’identité retournés pour le numéro transmis), signature (métadonnées de certification du jeu de données) et id (identifiant de requête). HTTP 404 : impossible de constituer un dossier complet pour ce numéro dans ce flux. HTTP 409 : échec de la validation d’entrée (p. ex. longueur de documentNumber) avant traitement. Coût en crédits par requête supérieur à /v2/co/cedula de base, en raison de la chaîne de résolution.

En-têtes

Nom	Valeur
Accept	application/json
Authorization	Bearer <token>

Paramètres

Nom	Type	Obligatoire	Description
documentNumber	string	Oui	Numéro de Cédula de Ciudadanía (CC) colombienne. Le serveur normalise sur les chiffres uniquement ; longueur 5 à 10 caractères (validation API).

Tarification dynamique

L’endpoint standard GET/POST /v2/co/cedula (cédula de base) participe à l’architecture Requête dynamique de Verifik. En règle générale, vous payez le tarif standard. Lorsque les chemins de vérification standard ne renvoient pas de correspondance, un chemin de vérification étendu peut s’exécuter automatiquement. Si ce chemin renvoie HTTP 200, la tarification dynamique s’applique et les crédits sont déduits au niveau premium de cette famille de points de terminaison.

Attente tarifaire : du tarif standard de votre compte · jusqu’au tarif premium (voir votre plan ou Postman).

Passez includeCost=true sur /v2/co/cedula pour recevoir un objet billing lorsque la tarification dynamique s’applique. Voir le SLA — Tarification dynamique (facturation).

Premium direct vs tarification dynamique

Cette page documente le point de terminaison premium explicite (/v2/co/cedula/premium). L’appeler directement utilise toujours la tarification premium.

La tarification dynamique décrit l’escalade automatique depuis /v2/co/cedula ; en cas de succès (HTTP 200), le même niveau premium que cette route est facturé.

Exemple de requête

GET

import axios from "axios";

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

POST

import axios from "axios";

const { data } = await axios.post(
	"https://api.verifik.co/v2/co/cedula/premium",
	{ documentNumber: "1234567890" },
	{
		headers: {
			Accept: "application/json",
			Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
		},
	}
);
console.log(data);

Réponse

200

Forme illustrative (valeurs fictives, non personnes réelles) :

{
	"data": {
		"arrayName": ["GIVEN", "MIDDLE", "PATERNAL", "MATERNAL"],
		"dateOfBirth": "1990-05-20",
		"documentNumber": "1234567890",
		"documentType": "CC",
		"expeditionDate": "2015-08-12",
		"expeditionPlace": {
			"municipio": "Municipalité d'exemple",
			"departamento": "Département d'exemple"
		},
		"firstName": "GIVEN MIDDLE",
		"fullName": "GIVEN MIDDLE PATERNAL MATERNAL",
		"gender": "HOMBRE",
		"isAlive": true,
		"lastName": "PATERNAL MATERNAL"
	},
	"signature": {
		"dateTime": "April 21, 2026 9:34 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "XXXXX"
}

La présence et le nom des champs reflètent la disponibilité des sources officielles.

404

{
	"code": "NotFound",
	"message": "Record not found."
}

Renvoyée lorsque les sources amont ne fournissent pas de correspondance ou de données requises (par exemple, échec de résolution de la date d'expédition).

409

{
	"code": "MissingParameter",
	"message": "documentNumber maximum length: 10\n"
}

La validation impose 5 à 10 caractères pour documentNumber ; d'autres messages Joi peuvent apparaître pour des entrées manquantes ou invalides.

Liens

• Cédula colombienne (basique) — GET/POST /v2/co/cedula (CC / PPT).
• Référence officielle en anglais : Colombian cédula premium.