Endpoint: certificados de formación (SENA)

Consulta los certificados de formación del SENA por documento o por el número de registro que aparece en el certificado. Devuelve el registro completo, el título, el tipo, el programa, la fecha de certificación y la fecha de firma. No publica el enlace de descarga del certificado, que vence en pocos minutos. «No se encontraron certificados» es una respuesta válida y cobra; una fuente caída no cobra.

POST/api/sena-certificados1 crédito

Certificados de formación del SENA por documento o por el número de registro que aparece en el certificado. Devuelve el registro completo, título, tipo, programa, fecha de certificación y fecha de firma. No publica el enlace de descarga: el enlace del certificado vence en 10 minutos. «No se encontraron certificados» responde 200 con encontrado: false y COBRA: es el hallazgo. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)

{
  "tipoDocumento": "CC",
  "documento": "1020304050"
}

Parámetros del cuerpo de la solicitud
Campo	Tipo	Qué es
tipoDocumento	string	Tipo de documento del `<select>` del SENA. Por defecto `CC`. Se ignora cuando se consulta por `registro`.Valores: `CC · CE · DNI · NCS · NIS · NIT · PAS · PEP · PEPT · PP · PPT · PR · PS · RC · RUI · SC2 · SCP · TI`
documento	string	Número de documento, de 1 a 20 caracteres (letras, números, espacio, punto o guion). Manda uno de `documento` o `registro`, no los dos. Alias: `documentNumber`, `docNumber`, `numeroDocumento`.
registro	string	Número de registro completo del certificado (3 a 50 caracteres), p. ej. el código que trae el PDF. Alias: `numeroRegistro`, `registration`.
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/sena-certificados' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"tipoDocumento":"CC","documento":"1020304050"}'

JavaScript (fetch)

const res = await fetch("https://placapi.com/api/sena-certificados", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"tipoDocumento":"CC","documento":"1020304050"}),
});
const data = await res.json();

Python (requests)

import requests

res = requests.post(
    "https://placapi.com/api/sena-certificados",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"tipoDocumento":"CC","documento":"1020304050"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)

{
  "source": "sena",
  "status": "ok",
  "data": {
    "encontrado": true,
    "total": 1,
    "certificados": [
      {
        "registro": "0000000000000CC0000000000N",
        "titulo": "TECNÓLOGO EN",
        "tipo": "Certificado Final",
        "programa": "PROGRAMA DE EJEMPLO",
        "certificacion": "2022-07-17",
        "firma": "2026-06-06"
      }
    ]
  },
  "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.