---
title: "GET /tools/api/list-spending-limits"
method: GET
path: "/tools/api/list-spending-limits"
tags: ["Spending Limits"]
---

# GET /tools/api/list-spending-limits

`GET /tools/api/list-spending-limits`

Lista todos os limites de gastos do usuário com informações detalhadas de uso atual e validação automática de quota. Para cada limite, calcula automaticamente o valor gasto no período atual, porcentagem de uso, valor restante e status visual. Por padrão retorna apenas limites ativos, mas pode incluir inativos com o parâmetro includeInactive. SEMPRE verifica e retorna informações detalhadas sobre cota do plano (Basic: 0 alertas, Pro: 2 alertas, Premium: 5 alertas) incluindo mensagens formatadas de status e upgrade quando necessário. Requer API key para autenticação e assinatura ativa.

## Query parameters

- `includeInactive` boolean

## Response `200`

Lista de limites de gastos

- object
  - `success` boolean
  - `data` SpendingLimitWithUsage[]
    - unknown
  - `count` number — Número de limites retornados
  - `quota` unknown
  - `filters` object
    - `includeInactive` boolean
  - `timestamp` string, date-time

## Other responses

- `401` — Authentication or subscription error
- `500` — Internal server error

---

[API](https://skmtc.net/pierre/apis/pierre-finance-api.md) · [All operations](https://skmtc.net/pierre/apis/pierre-finance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pierre/pierre-finance-api/versions/caa3b50e534e/schema)