endpoint.pe

Empresas · Fuente: SUNAT

API de trabajadores por RUC

Consulta la cantidad de trabajadores, pensionistas y prestadores de servicios que una empresa declara a SUNAT por periodo. Útil para evaluar el tamaño de clientes y proveedores.

Cómo consultarla

Haz una petición GET con tu token en la cabecera Authorization y recibe la respuesta en JSON. Elige tu lenguaje, copia el código y reemplaza TU_TOKEN por el de tu cuenta.

GET https://api.endpoint.pe/v1/ruc/20131312955/trabajadoresObtener mi token gratis
respuesta.json
{  "success": true,  "message": "Consulta exitosa",  "data": {    "ruc": "20131312955",    "razon_social": "SUPERINTENDENCIA NACIONAL DE ADUANAS Y DE ADMINISTRACION TRIBUTARIA - SUNAT",    "ultimo_periodo": {      "periodo": "2026-07",      "trabajadores": 12577,      "pensionistas": 1,      "prestadores_servicio": 4183    },    "cantidad_periodos": 22,    "periodos": [      {        "periodo": "2026-07",        "trabajadores": 12577,        "pensionistas": 1,        "prestadores_servicio": 4183      },      {        "periodo": "2026-06",        "trabajadores": 12602,        "pensionistas": 1,        "prestadores_servicio": 135      },      {        "periodo": "2026-05",        "trabajadores": 12541,        "pensionistas": 1,        "prestadores_servicio": 382      }    ]  },  "meta": {    "fuente": "SUNAT",    "consultado_en": "2026-10-12T07:40:12Z",    "creditos_cobrados": 1,    "creditos_disponibles": 14621  }}

Qué datos devuelve

Fuente oficial: SUNAT. Cada respuesta trae siempre los mismos campos, en JSON.
ruc

Número de RUC consultado.

razon_social

Razón social del RUC.

ultimo_periodo

El periodo más reciente declarado, con sus tres cifras.

cantidad_periodos

Periodos disponibles.

periodos

Lista del más reciente al más antiguo con periodo (AAAA-MM), trabajadores, pensionistas y prestadores_servicio.

Qué mide esta API y para qué sirve

Cada mes las empresas declaran su planilla a SUNAT y, a partir de ella, SUNAT publica por RUC la cantidad de trabajadores, de pensionistas y de prestadores de servicios de cada periodo. No hay nombres ni sueldos: solo cantidades, lo que permite publicarlas sin afectar datos personales.

La API de trabajadores de endpoint.pe devuelve, para un RUC, la lista de periodos disponibles del más reciente al más antiguo con esas tres cifras, y resume el último periodo para que no tengas que recorrer la lista. Si solo necesitas el número para una ficha rápida, la API de consulta RUC ya incluye la cantidad de trabajadores del último periodo.

Para qué se usa la API de trabajadores por RUC

Dimensionar clientes

Asigna planes o segmentos según el tamaño real de la empresa, con la cifra que declara a SUNAT.

Evaluar proveedores

Comprueba que un proveedor tiene el personal que dice tener antes de adjudicarle un servicio.

Seguir la tendencia

Compara periodos y detecta empresas que crecen o que reducen personal mes a mes.

Preguntas frecuentes

Preguntas sobre la API de trabajadores por RUC

Si tu duda no está aquí, escríbenos y te responde una persona del equipo.

Deja de copiar datos a mano. Automatízalo hoy mismo

Crea tu cuenta, copia tu token y empieza hoy con 150 consultas gratis al mes.