# List an agreement's billing runs (/api/usage-billing-runs/list-agreement-runs)

`GET https://api.comecero.com/api/v1/usage/agreements/{agreement_id}/runs`

Newest period first. For the next page, set `before` to the oldest `period_start` you got. Secret and trusted tokens may call it; a limited token may not (`403`).

## Parameters

- `agreement_id` (path, required): The agreement id.
- `before` (query): A date: only runs whose period_start is before it.
- `limit` (query): 1 to 100, default 25.

Responses: 200, 401, 403, 404, 500.

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