API de ARL en Colombia: afiliación a riesgos laborales por documento

PlacApi consulta el registro público de afiliación de la ARL SURA —la mayor administradora de riesgos laborales del país— y devuelve en JSON si la persona está afiliada, su estado, el nombre del afiliado y el código con el que se valida el certificado. Es la sección riesgosLaborales de /api/ruaf en versión puntual para una sola ARL: responde en segundos y por 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

Antes de firmar un contrato de obra o de prestación de servicios hay que saber si el contratista está cubierto por riesgos laborales. La consulta oficial vive en un formulario con iframe y la respuesta llega dentro de una ventana emergente, así que no encaja en un flujo automatizado. Este endpoint hace ese recorrido y entrega el veredicto estructurado.

Para quién sirve

Contratistas y constructoras que verifican cobertura antes de dejar entrar a alguien a una obra, áreas de compras y contratación, empresas de servicios temporales, y cualquier sistema que deba confirmar afiliación a riesgos laborales por API.

Datos requeridos

  • docType — tipo de documento (CC, CE, TI, PA, PPT…). Por defecto CC.
  • docNumber — número de documento. No se pide fecha de expedición.

Fuentes y cobertura

  • ARL SURA — consulta pública de afiliaciónRegistro de afiliación a riesgos laborales de SURA, con el certificado y su código de validación.

¿Cómo saber si alguien está afiliado a una ARL por API?

Con un POST a /api/arl-sura enviando docType y docNumber. La respuesta dice si está afiliado a la ARL SURA, con su estado y el código de validación del certificado.

¿Sirve para cualquier ARL?

No. Consulta el registro de la ARL SURA, que es la mayor del país. Si la persona está en otra ARL, la respuesta es 404 y no se cobra: 'no está en SURA' no es 'no tiene ARL'. Para cualquier administradora está /api/ruaf.

Ejemplo de solicitud

POST https://placapi.com/api/arl-sura. 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/arl-sura' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"docType":"CC","docNumber":"1020304050"}'

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": "arl-sura",
  "status": "info",
  "data": {
    "documento": "1020304050",
    "tipoDocumento": "CC",
    "afiliado": true,
    "nombre": "JUAN CARLOS PEREZ GOMEZ",
    "estado": "ACTIVO",
    "codigoValidacion": "A1B2C3D4"
  }
}

Explicación campo por campo

CampoTipoDescripción
afiliadobooleantrue si SURA reporta afiliación vigente a riesgos laborales.
estadostring|nullEstado que reporta el certificado. null si el certificado no llegó (el portal a veces lo corta) y solo se pudo confirmar el veredicto.
codigoValidacionstring|nullCódigo con el que se verifica el certificado en el portal de SURA.

Tiempo de respuesta

Alrededor de 3 segundos. El formulario público no valida captcha.

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. El mismo precio aplica por la web y por API. 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

1 día. La afiliación a riesgos laborales cambia con cada vinculación o retiro.

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

  • Cubre SOLO la ARL SURA. Es la más grande del país, pero un 'no afiliado' aquí no dice en qué otra ARL está la persona: por eso ese caso responde 404 y NO cobra.
  • El certificado no siempre llega (el portal corta la vuelta de forma intermitente): en ese caso el veredicto se entrega igual, con nombre y estado en null.
  • Para el panorama completo de seguridad social —salud, pensión y riesgos laborales de cualquier administradora— está /api/ruaf, que cuesta 2 créditos y exige la fecha de expedición del documento.
  • El portal limita las ráfagas: consultas seguidas desde la misma salida pueden tardar más.

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

Otras preguntas frecuentes

¿Por qué un no afiliado no cobra?

+

Porque el producto es el veredicto sobre la cobertura, y un 404 aquí no responde la pregunta del cliente: solo descarta una de las ARL. Cobrar media respuesta sería vender un dato a medias.

¿Qué diferencia hay con /api/ruaf?

+

El RUAF trae salud, pensión y riesgos laborales de cualquier administradora, pero exige la fecha de expedición del documento, cuesta 2 créditos y tarda decenas de segundos. Este endpoint responde solo por SURA, en segundos y por 1 crédito.

Seguir explorando

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

Contacto