> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/billing/usage — metered usage records

> Return metered usage over a time range and granularity: per-model quantity, unit, and cost. Amounts are in the wallet currency.

Return metered usage records over a time range and granularity. Each row includes the model, quantity, unit, and cost in the wallet currency.

**Method:** `GET` **Path:** `/api/billing/usage` **Auth:** Session Bearer

## Query parameters

<ParamField query="from" type="string">
  Start timestamp (ISO 8601 UTC). Defaults to start of the current month.
</ParamField>

<ParamField query="to" type="string">
  End timestamp (ISO 8601 UTC). Defaults to now.
</ParamField>

<ParamField query="granularity" type="string">
  `day` or `hour`. Default `day`.
</ParamField>

## Response

<ResponseField name="usage" type="object[]">
  <Expandable title="row">
    <ResponseField name="timestamp" type="string">
      Bucket start (ISO 8601).
    </ResponseField>

    <ResponseField name="model" type="string">
      Model slug.
    </ResponseField>

    <ResponseField name="quantity" type="number">
      Amount consumed.
    </ResponseField>

    <ResponseField name="unit" type="string">
      Pricing unit (for example `per_million_tokens`).
    </ResponseField>

    <ResponseField name="cost" type="number">
      Cost in `currency`.
    </ResponseField>

    <ResponseField name="currency" type="string">
      `USD` or `CNY`.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```bash theme={null}
curl -H "Authorization: Bearer eyJhbGciOi..." \
  "https://ariacompute.com/api/billing/usage?from=2026-09-01T00:00:00Z&granularity=day"
```

```json theme={null}
{
  "usage": [
    {
      "timestamp": "2026-09-22T00:00:00Z",
      "model": "gemma-4-e2b-it_q4",
      "quantity": 1250000,
      "unit": "per_million_tokens",
      "cost": 1.50,
      "currency": "USD"
    }
  ]
}
```


## Related topics

- [Prepaid wallet, top-ups, and usage billing](/concepts/wallet-billing.md)
- [Top up your wallet with Stripe, WeChat Pay, or Alipay](/guides/top-up-wallet.md)
- [GET /api/billing/summary — wallet and recent activity](/api-reference/billing/summary.md)
- [GET /api/billing/transactions — wallet transaction history](/api-reference/billing/transactions.md)
- [Aria Compute Documentation](/index.md)