# List billing agreements (/api/usage-agreements/list-usage-agreements)

`GET https://api.comecero.com/api/v1/usage/agreements`

By `agreement_id`. When `has_more` is `true`, ask again with `starting_after` set to the last id. A `limit` outside 1 to 100 is moved into that range. Secret and trusted tokens may call it; a limited token may not (`403`).

## Parameters

- `customer_id` (query): Only this customer's agreements.
- `subscription_id` (query): Only the agreements of this subscription.
- `starting_after` (query): An agreement_id: the page starts after it.
- `limit` (query): 1 to 100, default 25.

Responses: 200, 401, 403, 500.

Full schemas: operation `list_usage_agreements` in /openapi.json.