Colombia — COPNIA matrícula profesional por número

Verifik consulta COPNIA (Consejo Profesional Nacional de Ingeniería) con un solo licenseNumber (matrícula). Úsalo cuando ya tienes el número de registro y necesitas el titular y el estado.

Qué devuelve la API

• Campos de identidad: documentType, documentNumber, firstName, lastName, fullName, arrayName
• Campos de matrícula en el mismo objeto: licenseNumber, licenseStatus, licenseType, profession, resolutionDate, resolutionNumber
• Respuesta firmada por Verifik (sin arreglo licenses[])

Referencia de API

Endpoint

GET https://api.verifik.co/v2/co/copnia/matricula

Envía licenseNumber como parámetro de consulta. El manejador devuelve la persona y los seis campos de la matrícula en el mismo objeto. Un valor típico es 091132-0839078 CNDC (6–40 caracteres).

Encabezados

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parámetros

Name	Type	Required	Description	Example
licenseNumber	string	Sí	Número de matrícula COPNIA, 6–40 caracteres. Se permiten espacios.	091132-0839078 CNDC

Solicitud

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/copnia/matricula", {
	params: {
		licenseNumber: "091132-0839078 CNDC",
	},
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/copnia/matricula"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"licenseNumber": "091132-0839078 CNDC"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Respuesta

200

{
	"data": {
		"arrayName": ["HENRY", "ANDRES", "CASTANEDA", "ACOSTA"],
		"documentNumber": "80176161",
		"documentType": "CC",
		"firstName": "HENRY ANDRES",
		"fullName": "HENRY ANDRES CASTANEDA ACOSTA",
		"lastName": "CASTANEDA ACOSTA",
		"licenseNumber": "091132-0839078 CNDC",
		"licenseStatus": "VIGENTE",
		"licenseType": "MATRICULA PROFESIONAL",
		"profession": "INGENIERIA DE SOFTWARE",
		"resolutionDate": "2026-07-27",
		"resolutionNumber": "RN2026NALA032094"
	},
	"signature": {
		"dateTime": "September 15, 2026 9:00 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "ABCDE"
}

404

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

409

{
	"code": "MissingParameter",
	"message": "licenseNumber length must be at least 6 characters long"
}

Características

• Consulta por matrícula sin enviar número de documento
• Solo GET con parámetros de consulta
• Sandbox devuelve un payload COPNIA fijo para la matrícula de ejemplo
• Respuestas firmadas y facturadas como feature híbrido apiRequest

Casos de uso

• Confirmar una matrícula impresa o enviada
• Revisar el estado (VIGENTE u otros valores de la fuente) en el onboarding
• Contrastar una matrícula hallada antes con COPNIA por documento

Notas

• Ejemplo sandbox: 091132-0839078 CNDC. La persona asociada es CC / 80176161.
• Si el valor se normaliza a vacío, la API responde 409 (invalid_license_number).
• Una falla de sesión o de la fuente puede devolver 409 con timeout_data_source.
• Trata la respuesta como dato personal sensible y cumple habeas data.