Endpoint: afiliación a ARL SURA (riesgos laborales)

Con el documento de una persona devuelve si está afiliada a riesgos laborales en la ARL SURA —la administradora más grande del país—, el estado de la afiliación, el nombre del afiliado y el código de validación del certificado oficial. Responde en segundos y no pide la fecha de expedición del documento. Para saber EN CUÁL ARL está una persona (Positiva, Colmena, SURA…), la respuesta completa es `/api/ruaf`.

POST/api/arl-sura1 crédito

La afiliación a riesgos laborales de una persona en la ARL SURA —la administradora más grande del país— por documento, sin fecha de expedición. Devuelve el veredicto afiliado, el estado de la afiliación, el nombre del afiliado y el codigoValidacion del certificado oficial (validable por un mes en arlsura.com.co). Responde en segundos. Es la sección riesgosLaborales de /api/ruaf en versión puntual para una ARL: aquella exige la fecha de expedición y cuesta 2 créditos con decenas de segundos de espera; esta responde "¿está afiliado a ARL SURA?" por 1. ⚠️ No cubre las otras ARL (Positiva, Colmena…): para saber EN CUÁL está una persona, la respuesta completa es /api/ruaf. Una persona no afiliada a ARL SURA responde 404 y NO cobra (no es una negativa completa: SURA es una de varias ARL). Cuesta 1 crédito.

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`. Es el universo de personas del portal de ARL SURA: PEP = Permiso Especial de Permanencia, PPT = Permiso por Protección Temporal. Con NIT responde 400 `bad_request` sin cobrar: esta consulta es de afiliación de personas, no de empresas.Valores: CC · CE · TI · RC · PA · CD · SC · PEP · PPT
docNumberobligatoriostringNúmero de documento: de 3 a 16 caracteres, letras mayúsculas o dígitos (el pasaporte lleva letras; el rango es el que valida el portal). 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/arl-sura' \
  -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/arl-sura", {
  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/arl-sura",
    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": "arl-sura",
  "status": "info",
  "data": {
    "documento": "1020304050",
    "tipoDocumento": "CC",
    "afiliado": true,
    "estado": "ACTIVO",
    "nombre": "MARIA FERNANDA GOMEZ RUIZ",
    "fechaCertificacion": "07 de septiembre de 2026",
    "codigoValidacion": "C10203040501234567890"
  },
  "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: 7 de septiembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto