> ## Documentation Index
> Fetch the complete documentation index at: https://docs.json.pe/llms.txt
> Use this file to discover all available pages before exploring further.

# RUC - Trabajadores

> Consulta trabajadores por RUC.



## OpenAPI

````yaml POST /ruc/trabajadores
openapi: 3.0.1
info:
  title: json.pe - API Consulta RUC, DNI, Placa, SOAT, Licencia de Conducir y más
  description: >-
    Documentación oficial de [json.pe](https://json.pe) — API Consulta RUC, DNI,
    Placa, SOAT, Licencia de Conducir y más. Regístrate gratis en
    [json.pe/signup](https://json.pe/signup).
  version: 1.0.0
servers:
  - url: https://api.json.pe/api
security:
  - bearerAuth: []
paths:
  /ruc/trabajadores:
    post:
      tags:
        - ruc
      description: Consulta trabajadores por RUC.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ruc-request'
      responses:
        '200':
          description: ruc trabajadores response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ruc-trabajadores'
        '400':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
components:
  schemas:
    ruc-request:
      type: object
      required:
        - ruc
      properties:
        ruc:
          type: string
          description: El RUC a consultar
          example: '20552103816'
      example:
        ruc: '20552103816'
    ruc-trabajadores:
      type: object
      properties:
        success:
          type: boolean
          description: El estado de la respuesta true o false
        message:
          type: string
          description: Mensaje de la respuesta
        data:
          type: array
          description: Serie histórica por período (año-mes)
          items:
            type: object
            properties:
              periodo:
                type: string
                description: Período en formato YYYY-MM
              numero_trabajadores:
                type: string
                description: Número de trabajadores declarados
              numero_pensionistas:
                type: string
                description: Número de pensionistas
              numero_prestadores_de_servicio:
                type: string
                description: Número de prestadores de servicio
      example:
        success: true
        message: exito
        data:
          - periodo: 2025-02
            numero_trabajadores: 19 810
            numero_pensionistas: '2'
            numero_prestadores_de_servicio: '155'
          - periodo: 2025-03
            numero_trabajadores: 19 946
            numero_pensionistas: '2'
            numero_prestadores_de_servicio: '162'
          - periodo: 2025-04
            numero_trabajadores: 23 305
            numero_pensionistas: '2'
            numero_prestadores_de_servicio: '136'
          - periodo: 2025-05
            numero_trabajadores: 20 445
            numero_pensionistas: '2'
            numero_prestadores_de_servicio: '169'
          - periodo: 2025-06
            numero_trabajadores: 20 388
            numero_pensionistas: '2'
            numero_prestadores_de_servicio: '153'
          - periodo: 2025-07
            numero_trabajadores: 20 478
            numero_pensionistas: '2'
            numero_prestadores_de_servicio: '164'
          - periodo: 2025-08
            numero_trabajadores: 20 719
            numero_pensionistas: '2'
            numero_prestadores_de_servicio: '169'
          - periodo: 2025-09
            numero_trabajadores: 20 890
            numero_pensionistas: '2'
            numero_prestadores_de_servicio: '153'
          - periodo: 2025-10
            numero_trabajadores: 20 892
            numero_pensionistas: '2'
            numero_prestadores_de_servicio: '181'
          - periodo: 2025-11
            numero_trabajadores: 21 045
            numero_pensionistas: '1'
            numero_prestadores_de_servicio: '159'
          - periodo: 2025-12
            numero_trabajadores: 21 202
            numero_pensionistas: '1'
            numero_prestadores_de_servicio: '171'
          - periodo: 2026-01
            numero_trabajadores: 21 207
            numero_pensionistas: '1'
            numero_prestadores_de_servicio: '145'
    error:
      required:
        - message
        - success
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
      example:
        success: false
        message: Bad Request
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````