# Get an entitlement's balance (/api/usage-entitlements/get-entitlement-balance)

`GET https://api.comecero.com/api/v1/usage/entitlements/{entitlement_id}/balance`

For a credit entitlement, the credit left in the agreement's currency. Secret and trusted tokens may call it; a limited token may not (`403`).

## Parameters

- `entitlement_id` (path, required): The entitlement id.
- `billing_region` (query): The entitlement's region. Defaults to us.

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

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