# Get usage this period so far (/api/usage-agreements/get-usage-so-far)

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

Used, included, percent and amount so far for each metered entitlement, worked out as the next bill will be, before prepaid credit. Kept for 5 minutes, so it can be a few minutes behind. Secret and trusted tokens may call it; a limited token may not (`403`).

## Parameters

- `agreement_id` (path, required): The agreement id.

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

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