Usage

Get usage snapshot

Returns each of the customer's active plans with its current remaining balance and expiry. This is a live snapshot (refreshed roughly every 30 minutes upstream), not a historical time series — there's no duration or granularity parameter.

GET /v1/customers/{username}/usage

{
  "plans": [
    { "id": "plan_9f2a...", "productId": "residential-premium", "remainingGb": 12.4, "expiresAt": null }
  ]
}