---
title: "GET Company usage"
method: GET
path: "/api/companies/{company_id}/usage"
---

# GET Company usage

`GET /api/companies/{company_id}/usage`

## Request

- Base URL: `https://app.plugsign.com.br`
- URL: `https://app.plugsign.com.br/api/companies/{company_id}/usage`
- Auth: API key in header `Authorization`

Retorna o histórico mensal de uso (arquivos, disco e assinaturas) da empresa informada: a sua própria empresa ou, para contas revendedoras, uma de suas subcontas. Empresas fora desse escopo respondem `404`.

Os dados são agrupados por mês (chave `month`, formato `AAAA-MM`), do mês mais recente para o mais antigo, com 50 registros por página. O registro do mês corrente é calculado no momento da consulta (arquivos e assinaturas do período; disco = soma do tamanho dos arquivos da empresa) e pode vir com `id` null.

## Path parameters

- `company_id` integer, required

## Response `200`

200

- object
  - `data` object[]: Lista de registros de uso da empresa agrupados por mês.
    - `id` integer: Identificador do registro; null no registro calculado do mês corrente.
    - `company` integer: Identificador da empresa à qual o registro pertence.
    - `files` integer: Quantidade de arquivos no mês.
    - `disk` string: Uso de disco no mês (soma do tamanho dos arquivos). Vem como string.
    - `signatures` integer: Quantidade de assinaturas no mês.
    - `month` string: Mês de referência no formato AAAA-MM.
  - `links` object: Links de navegação da paginação.
    - `first` string: URL da primeira página.
    - `last` string: URL da última página.
    - `prev` string: URL da página anterior, ou null se não houver.
    - `next` string: URL da próxima página, ou null se não houver.
  - `meta` object: Informações de paginação.
    - `current_page` integer: Número da página atual.
    - `from` integer: Índice do primeiro item da página atual.
    - `last_page` integer: Número da última página.
    - `links` object[]: Lista de links de navegação da paginação.
      - `url` string: URL da página correspondente ao link de navegação.
      - `label` string: Texto exibido no link de paginação.
      - `active` boolean: Indica se este link representa a página atual.
    - `path` string: URL base da paginação.
    - `per_page` integer: Quantidade de itens por página.
    - `to` integer: Índice do último item da página atual.
    - `total` integer: Total de registros mensais.

## Other responses

- `404`: Empresa inexistente ou fora do seu escopo (não é a sua empresa nem uma subconta sua)

## Changes

- **2026-11-03** `3db1513040ea`: 1 breaking, 1 warning, 2 info
  - the `data/items/disk` response's property type changed from `integer` to `string` for status `200`
  - removed the optional property `data/items/mont` from the response with the `200` status
  - added the non-success response with the status `404`
  - added the optional property `data/items/month` to the response with the `200` status

[Operation history](https://skmtc.dev/plugsign/apis/endpoints-manuais/changes/api/companies/:company_id/usage/get.md)

---

[API](https://skmtc.dev/plugsign/apis/endpoints-manuais.md) - [All operations](https://skmtc.dev/plugsign/apis/endpoints-manuais/llms.txt) - [OpenAPI document](https://skmtc.dev/plugsign/apis/endpoints-manuais/revisions/3db1513040ea?raw)