List an agreement's entitlements
Every entitlement of the agreement, in any status, by drawdown_priority. Secret and trusted tokens may call it; a limited token may not (403).
AuthorizationBearer <token>A secret, trusted or limited token. See Authentication.
agreement_id*stringThe agreement id.
Success.
application/json- response
data?array<>The list.
curl -X GET 'https://api.comecero.com/api/v1/usage/agreements/string/entitlements'{ "data": [ { "object": "entitlement_grant", "entitlement_id": "ent_cust_8412_ai_tokens", "kind": "metered", "billing_agreement_id": "agr_cust_8412", "metric_id": "met_ai_tokens", "rate_plan_id": "ai_tokens_standard", "rate_plan_version": 1, "funding_source_entitlement_id": "credit_cust_8412", "overage_policy": "allow", "drawdown_priority": 0, "capacity": null, "status": "active", "effective_from": "2026-11-01T00:00:00Z", "effective_to": null, "customer_id": "cust_8412", "billing_region": "us", "test": false } ]}Get usage this period so far GET
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`).
Find a customer's subscription GET
Finds the one active billing agreement that covers your customer id at a time, and the subscription it bills. Use it to check which subscription usage sent now (or at `occurred_at`) will be billed to. Secret and trusted tokens may call it; a limited token may not (`403`).