Endpoint: matrícula profesional de ingeniero (COPNIA)

Con el documento de una persona responde si tiene matrícula profesional ante el Consejo Profesional Nacional de Ingeniería (COPNIA), con el número de matrícula, la profesión y el estado. Es la verificación que exigen la contratación de obra, las interventorías y los firmantes de diseños y planos. Consulta el registro general de ingeniería y sus profesiones auxiliares y afines: las ingenierías con consejo profesional propio no aparecen ahí. Un «no se encontraron matrículas» es una respuesta válida y se cobra.

POST/api/tarjeta-profesional-ingeniero1 crédito

Si una persona tiene matrícula profesional en el registro general de ingeniería y sus profesiones auxiliares y afines, por documento: número de matrícula, profesión, fecha de la resolución y estado (estado, p. ej. «VIGENTE»; vigente true/false cuando el estado lo dice, null si no se reconoce). Con varias matrículas, profesionDetalle las lista todas y el número, estado y fecha son de la primera. Responde en ~1 s. Un documento sin matrículas responde 200 con inscrito: false y COBRA. ⚠️ Las ingenierías con consejo profesional propio (eléctrica, mecánica y afines, química, de petróleos…) no aparecen en este registro: un inscrito: false no prueba que la persona carezca de matrícula. Cuesta 1 crédito.

Para qué sirve, quién lo usa y cuánto cuesta: API del COPNIA.

Cuerpo de la solicitud

body (JSON)
{
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
docTypestringTipo de documento. Por defecto `CC`. Con otro valor (p. ej. NIT) responde 400 `bad_request` sin cobrar.Valores: CC · CE · PEP · PA · TI · PPT
docNumberobligatoriostringNúmero de documento: de 1 a 20 caracteres, letras o dígitos (pasaporte y permisos son alfanuméricos). Alias aceptados: `doc`, `documento`.
refreshbooleanIgnora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL
curl -X POST 'https://placapi.com/api/tarjeta-profesional-ingeniero' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"docType":"CC","docNumber":"1020304050"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/tarjeta-profesional-ingeniero", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"docType":"CC","docNumber":"1020304050"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/tarjeta-profesional-ingeniero",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"docType":"CC","docNumber":"1020304050"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "source": "tarjeta-profesional",
  "status": "ok",
  "data": {
    "profesion": "ingeniero",
    "documento": "1020304050",
    "tipoDocumento": "CC",
    "inscrito": true,
    "nombre": "JUAN CARLOS PEREZ GOMEZ",
    "numeroTarjeta": "05202-12345",
    "estado": "VIGENTE",
    "vigente": true,
    "fechaInscripcion": "2001-06-15",
    "profesionDetalle": "INGENIERIA CIVIL",
    "certificado": null
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 16 de octubre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto