Skip to main content

Colômbia — Cédula nacional premium (CC)

Finalidade: validar uma Cédula de Ciudadanía (CC) perante fontes oficiais e retornar um registro de identidade estruturado para KYC e conformidade, e não apenas um sim/não sobre o número. A resposta consolida nome conforme o cadastro, data de nascimento, local e data de expedição e, quando houver, gênero e sinal de vida, com bloco de certificação assinada. Apenas o número é informado; a data de expedição é resolvida no servidor (sem tipo de documento ou data na requisição). Nível de detalhe equivalente à cédula extra. O custo de créditos é maior que o do endpoint básico devido à cadeia de resolução.

Referência da API​

Endpoint​

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

Resposta: retorna data (atributos de identidade retornados para o número informado), signature (metadados de certificação do payload) e id (identificador da requisição). HTTP 404 indica que não foi possível montar um registro completo para o número neste fluxo. HTTP 409 indica falha de validação de entrada (p. ex. comprimento de documentNumber) antes do processamento. Custo de créditos por requisição superior ao de /v2/co/cedula básico, pela cadeia de resolução.

Cabeçalhos​

NomeValor
Acceptapplication/json
AuthorizationBearer <token>

Parâmetros​

NomeTipoObrigatórioDescrição
documentNumberstringSimNúmero da Cédula de Ciudadanía (CC). O servidor normaliza para somente dígitos; o comprimento deve ficar entre 5 e 10 caracteres (validação de API).

Solicitação​

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

Resposta​

Forma ilustrativa (valores de exemplo, não pessoas reais):

{
	"data": {
		"arrayName": ["GIVEN", "MIDDLE", "PATERNAL", "MATERNAL"],
		"dateOfBirth": "1990-05-20",
		"documentNumber": "1234567890",
		"documentType": "CC",
		"expeditionDate": "2015-08-12",
		"expeditionPlace": {
			"municipio": "Município de exemplo",
			"departamento": "Departamento de exemplo"
		},
		"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"
}

Os nomes de campos e sua presença podem variar conforme as fontes oficiais.

Relacionados​