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

# Obtener operaciones de una empresa

> Devuelve el número de operaciones realizadas por una empresa en un año y mes determinados.



## OpenAPI

````yaml /api-reference/openapi/openapi.yaml get /api/clientcompanies/{companyId}/requests
openapi: 3.0.0
info:
  title: Kubifactu API
  description: API para el procesamiento y gestión de facturas de Veri*Factu
  version: 1.0.0
  contact:
    email: soporte@kubifactu.com
    name: Soporte KubiFACTU
    url: https://apidocs.kubifactu.com
servers:
  - url: https://api.kubifactu.com
    description: Servidor de producción
  - url: https://devapi.kubifactu.com
    description: Servidor de pruebas
security: []
paths:
  /api/clientcompanies/{companyId}/requests:
    get:
      summary: Obtener operaciones de una empresa
      description: >-
        Devuelve el número de operaciones realizadas por una empresa en un año y
        mes determinados.
      operationId: showClientCompanyRequests
      parameters:
        - name: companyId
          in: path
          description: |
            ID de la empresa.
          required: true
          schema:
            type: string
        - name: year
          in: query
          description: |
            Año sobre el que hacer la consulta. Por defecto, el año en curso.
          required: false
          schema:
            type: integer
            example: 2025
        - name: month
          in: query
          description: >
            Mes sobre el que hacer la consulta (1 = Enero, 12 = Diciembre). Por
            defecto, el mes en curso.
          required: false
          schema:
            type: integer
            example: 11
      responses:
        '200':
          description: Datos de la empresa.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      client_company_id:
                        type: string
                        format: uuid
                        description: Identificador único de la empresa.
                        example: 9dcccd85-496d-4ed8-8f78-edfacac68964
                      requests_count:
                        type: integer
                        description: >-
                          Número de operaciones realizadas por la empresa en el
                          periodo solicitado.
                        example: 258
        '403':
          description: No autorizado. La API-KEY proporcionada no es válida.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedApiKeyErrorResponse'
        '404':
          description: No encontrado. La empresa con el ID indicado no ha sido encontrada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundErrorResponse'
        '500':
          description: Error interno del servidor.
      security:
        - owner_api_key: []
components:
  schemas:
    UnauthorizedApiKeyErrorResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            error:
              type: object
              properties:
                code:
                  type: string
                  description: Código de error que indica el tipo de problema.
                  example: E-UNAUTH-APIKEY
                message:
                  type: string
                  description: Mensaje detallado del error.
                  example: >-
                    No client with API-KEY
                    '5tVySMGJOpq8HfMgIX28Qz6kF0dFOoq37x55PLZcWsGeGeYkNgJyAcRTlFJ5NbVoDRm8qtCywEoiN3A9JkBanMBXYmxiqR3BItxgxx'
                    was found.
                http_code:
                  type: integer
                  description: Código HTTP asociado al error.
                  example: 403
                errors:
                  type: object
                  nullable: true
                  description: >
                    Detalles adicionales del error. Puede ser `null` si no hay
                    información específica.
                  example: null
                details:
                  type: object
                  properties:
                    request_id:
                      type: string
                      description: Identificador único de la solicitud para rastreo.
                      example: 2cc8ef846029ec69613711ad1d85f6dfebf16ffb
    NotFoundErrorResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            error:
              type: object
              properties:
                message:
                  type: string
                  description: Mensaje detallado del error.
                  example: >-
                    Client Company with id
                    [0195fa87-a315-710a-8aa2-25e1d690f6tr] not found.
                errors:
                  type: object
                  nullable: true
                  description: >
                    Detalles adicionales del error. Puede ser `null` si no hay
                    información específica.
                  example: null
                details:
                  type: object
                  properties:
                    request_id:
                      type: string
                      description: Identificador único de la solicitud para rastreo.
                      example: 2cc8ef846029ec69613711ad1d85f6dfebf16ffb
  securitySchemes:
    owner_api_key:
      type: apiKey
      name: X-Qbikode-UserApiKey
      in: header
      description: >
        API-KEY del intermediario que hace la petición. Este dato se puede
        consultar en el panel web, en la página de _Perfil de usuario_.

````