Listar registros de uso

GET 
/v1/usage

Retorna os registros de uso (metered) de um item de assinatura. Identifique o item por subscription_item_id ou pela combinação product_slug + customer_id. Suporta filtros por intervalo de datas e janela com limit/offset.

Request

Responses

200

Lista de registros de uso com agregação total_quantity no meta.

400

Corpo da requisição falhou na validação.

401

Token bearer ausente ou inválido.

403

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"].

404

Recurso não encontrado na organização atual.

429

Limite de requisições excedido.

500

Erro inesperado no servidor.