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.
Descrição
O endpointGET /tools/api/list-spending-limits retorna a lista completa de alertas de gastos configurados pelo usuário, incluindo o gasto atual de cada período, percentual utilizado e informações sobre a quota disponível no plano do usuário.
Autenticação
Este endpoint requer autenticação via Bearer token.Bearer sk-your-api-key-hereParâmetros de Query
true, retorna também os alertas inativos. Por padrão, retorna apenas alertas ativos (false).s=s para requisições MCP.Resposta
Sucesso (200)
Erro de Autenticação (401)
Erro de Quota Excedida (403)
Campos da Resposta
Exemplos de Uso
cURL
JavaScript
Python
Códigos de Status
200: Sucesso - Alertas retornados401: Erro de autenticação ou assinatura403: Quota excedida (ao tentar criar novos alertas)500: Erro interno do servidor
Limites por Plano
- FREE: 3 alertas de gastos
- PRO: 10 alertas de gastos
- PREMIUM: 30 alertas de gastos
ok para 0-49%, warning para 50-74%, e danger para 75% ou mais do limite.Authorizations
API key in Bearer token format. Example: Bearer sk-your-api-key-here
Query Parameters
Se deve incluir limites inativos na resposta

