Endpoint: matrícula profesional de ingeniería (COPNIA)

Verifica una matrícula profesional de ingeniería por su número en el registro de COPNIA. Devuelve si está inscrita, el estado y la vigencia, la profesión, el tipo de matrícula, la fecha y el número de la resolución y el nombre del titular. No publica la cédula, que no es necesaria para verificar la matrícula. Una matrícula que no figura es un hallazgo y cobra; una fuente caída reembolsa.

POST/api/copnia-matricula1 crédito

Consulta una matrícula profesional de ingeniería por su NÚMERO de matrícula en COPNIA (el modo SearchWithCode=2 del mismo registro que usa /api/tarjeta-profesional-ingeniero, que consulta por documento). Devuelve si la matrícula figura, su estado (estado, p. ej. «VIGENTE» o «SUSPENDIDA»; vigente true/false cuando el estado lo dice, null si no se reconoce), el nombre del titular, la profesión, el tipo de matrícula, la fecha de la resolución nacional y su número. No publica la cédula: el cliente no la aportó y no hace falta para verificar la matrícula. Una matrícula que no figura responde 200 con inscrito: false y COBRA. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)

{
  "matricula": "00000-00000"
}

Parámetros del cuerpo de la solicitud
Campo	Tipo	Qué es
matriculaobligatorio	string	Número de matrícula COPNIA, de 3 a 30 caracteres: letras, números, espacio y guion. Se aceptan los formatos `00000-00000` y `TEST-00001`. Alias aceptados: `numeroMatricula`, `registro`.
refresh	boolean	Ignora 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/copnia-matricula' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"matricula":"00000-00000"}'

JavaScript (fetch)

const res = await fetch("https://placapi.com/api/copnia-matricula", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"matricula":"00000-00000"}),
});
const data = await res.json();

Python (requests)

import requests

res = requests.post(
    "https://placapi.com/api/copnia-matricula",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"matricula":"00000-00000"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)

{
  "source": "tarjeta-profesional",
  "status": "info",
  "data": {
    "inscrito": false,
    "matricula": "00000-00000",
    "estado": null,
    "vigente": null,
    "nombre": null,
    "profesionDetalle": null,
    "tipoMatricula": null,
    "fechaResolucion": null,
    "numeroResolucion": 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: 30 de octubre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.