Resumo de uso do período
GET/v1/usage/summary
Retorna a agregação de uso de um item de assinatura no período de cobrança vigente (ou em um período arbitrário via period_start/period_end). Considera registros set (substituem) e somatórios de increment posteriores. Quando o preço é tiered ou unitário, calcula um custo estimado em estimated_cost (float, até 4 casas decimais).
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
Resumo de uso, período e custo estimado.
Corpo da requisição falhou na validação.
Token bearer ausente ou inválido.
Token válido, porém sem permissão para esta operação. Com code insufficient_scope, details.required traz o único conjunto mínimo de escopos que, somados a details.granted, deixaria a requisição passar: o escopo do recurso (billing/{recurso}, ou billing/all fora do catálogo) e depois o verbo puro — por exemplo ["billing/customers", "delete"].
Recurso não encontrado na organização atual.
Limite de requisições excedido.
Erro inesperado no servidor.