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",
      "productKey": "premium",
      "remainingGb": 12.4,
      "totalGb": 20,
      "usedGb": 7.6,
      "expiresAt": null
    }
  ],
  "pending": []
}