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

Exemple de requête

GET
POST

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

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

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.

{
	"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).

{
	"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.

Référence API​

Point de terminaison​

En-têtes​

Paramètres​

Exemple de requête​

Réponse​

Liens​