endpoint.pe

Trabajadores

Cantidad de trabajadores, pensionistas y prestadores de servicio que una empresa declara a SUNAT, periodo a periodo.

GEThttps://api.endpoint.pe/v1/ruc/{ruc}/trabajadores
Fuente:
SUNAT
Costo:
1 crédito por consulta con resultado
Estado:
Disponible
Probar en el playground Página de la API

Devuelve, por periodo mensual, cuántos trabajadores, pensionistas y prestadores de servicio declaró el contribuyente a SUNAT, del periodo más reciente al más antiguo. Es un buen indicador del tamaño real de un cliente o proveedor y de cómo ha evolucionado.

Parámetros

NombreDóndeFormato
rucRuta11 dígitos con dígito verificador correcto, como en Consulta RUC.

Ejemplo

La respuesta está recortada a tres periodos; la real trae los 22.

terminal
curl 'https://api.endpoint.pe/v1/ruc/20131312955/trabajadores' \  -H 'Authorization: Bearer TU_TOKEN'
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  }}

Campos de data

CampoDescripción
rucNúmero de RUC consultado.
razon_socialRazón social del RUC.
ultimo_periodoEl periodo más reciente declarado, con sus tres cifras.
cantidad_periodosPeriodos disponibles.
periodosLista del más reciente al más antiguo con periodo (AAAA-MM), trabajadores, pensionistas y prestadores_servicio.

Detalles

  • periodo tiene formato AAAA-MM. ultimo_periodo repite el primer elemento de periodos para que no tengas que buscarlo.
  • Si el RUC está inscrito pero no tiene periodos declarados, la respuesta es 200 con ultimo_periodo: null, cantidad_periodos: 0 y periodos: [], y descuenta un crédito.
  • Si solo necesitas la cifra más reciente, Consulta RUC ya la trae en cantidad_trabajadores, dentro de la misma consulta.

Guía: Cantidad de trabajadores de una empresa en SUNAT.

Errores

HTTPerrorCuándo
404no_encontradoEl RUC no está inscrito en el padrón. No descuenta créditos.
422validaciondetalles.ruc: "RUC inválido: deben ser 11 dígitos con dígito verificador correcto."

Los demás códigos (401, 402, 403, 502) son comunes a todas las APIs: Errores.

Relacionados