API del COPNIA: verificar la matrícula profesional de un ingeniero

PlacApi responde en JSON, en ~1 segundo, si una persona tiene matrícula profesional ante el Consejo Profesional Nacional de Ingeniería (COPNIA), con el número de matrícula, la profesión, la fecha de la resolución y el estado. Es la verificación que exigen la contratación de obra, las interventorías y quienes reciben diseños y planos firmados. Cuesta 1 crédito.

Probar en el sandbox y generar API keyVer precios por consulta

¿No eres desarrollador? Consulta el RUNT por placa aquí sin escribir código.

Qué problema resuelve

Buena parte de la ingeniería en Colombia exige matrícula profesional, y una obra o un diseño firmado por quien no la tiene es un riesgo legal para el contratante. Verificarla es una consulta manual por persona. Este endpoint la vuelve una llamada que se puede meter en el alta de proveedores o en la revisión de una propuesta. Consulta el registro general de ingeniería y sus profesiones auxiliares y afines; las ingenierías con consejo profesional propio no aparecen ahí.

Para quién sirve

Constructoras e interventorías, áreas de compras que contratan servicios de ingeniería, entidades públicas que evalúan propuestas, curadurías y aseguradoras que reciben diseños firmados.

Datos requeridos

  • docType — CC, CE, PEP, PA, TI o PPT. Por defecto CC.
  • docNumber — número de documento del ingeniero.

Fuentes y cobertura

  • Consejo Profesional Nacional de Ingeniería (COPNIA)Registro de matrículas profesionales de ingeniería, sus profesiones auxiliares y afines, con su estado.

¿Cuánto cuesta verificar una matrícula de ingeniero por API?

1 crédito por consulta, y un «sin matrículas» también se cobra. Una consulta servida de caché no cobra.

¿Cómo verificar por API si un ingeniero tiene matrícula profesional?

Con un POST a /api/tarjeta-profesional-ingeniero enviando docType y docNumber.

Ejemplo de solicitud

POST https://placapi.com/api/tarjeta-profesional-ingeniero. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.

Ejemplo cURL de la solicitud
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"}'

Parámetros, errores y ejemplos en cURL, JavaScript y Python: documentación de POST /api/tarjeta-profesional-ingeniero.

Ejemplo de respuesta

Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).

Ejemplo de respuesta JSON
{
  "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"
  }
}

Explicación campo por campo

CampoTipoDescripción
inscritobooleantrue si la persona tiene al menos una matrícula. false es una respuesta válida y se cobra.
numeroTarjetastringNúmero de la matrícula profesional.
profesionDetallestringProfesión de la matrícula; con varias matrículas, todas separadas por punto y coma.
vigenteboolean | nulltrue o false cuando el estado lo dice; null si no se reconoce.

Tiempo de respuesta

~1 segundo.

Precio y cobro

1 crédito por consulta con datos, desde 349 COP. El precio por crédito baja por volumen: 349 COP desde 30, 249 COP desde 1.000, 149 COP desde 5.000, 139 COP desde 10.000, 119 COP desde 20.000, 99 COP desde 50.000. Los créditos se compran por adelantado (mínimo 30 = 10.470 COP), no vencen y no hay mensualidad. Por la web, el informe completo por placa cuesta 3 créditos. Solo se cobra cuando la consulta devuelve datos; por API, las consultas sin resultado (404) tienen 10 gratis al mes por cada tipo de respuesta sin datos y después cobran igual.

Caché y actualización

7 días cuando tiene matrícula; 1 hora cuando no, para que un documento mal digitado no herede el «no registra».

Seguridad y privacidad

La placa y el documento se usan solo para ejecutar la consulta; el resultado queda en caché temporal. No se almacenan datos de tarjetas (los pagos los procesa Wompi). Ver privacidad y seguridad.

Limitaciones y posibles errores

  • Consulta el registro general de ingeniería y sus profesiones auxiliares y afines. Las ingenierías con consejo profesional propio (eléctrica, mecánica y afines, química, de petróleos…) no aparecen ahí: un inscrito: false no prueba que la persona carezca de matrícula.
  • Con varias matrículas, el número, el estado y la fecha son los de la primera; profesionDetalle las lista todas.
  • No incluye las sanciones del ejercicio profesional.

Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.

Otras preguntas frecuentes

¿Cubre técnicos y tecnólogos?

+

Cubre lo que registra el consejo: ingeniería y sus profesiones auxiliares y afines.

¿Un `inscrito: false` significa que no tiene matrícula?

+

No necesariamente. Las ingenierías con consejo profesional propio (eléctrica, mecánica y afines, química, de petróleos…) no aparecen en este registro, así que un ingeniero de esas ramas puede tener matrícula vigente y responder inscrito: false.

Seguir explorando

Última revisión: 16 de octubre de 2026 · Versión de la API: v1 · Fuentes y metodología

Contacto