> ## 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/summary — wallet and recent activity

> Return a single payload with the wallet balance, recent payments, recent transactions, and month-to-date usage for the dashboard overview.

Return a single payload that powers the billing overview in the dashboard: current wallet balance, recent payments, recent transactions, and month-to-date usage totals.

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

## Response

<ResponseField name="wallet" type="object">
  Current wallet snapshot with `balance` and `currency`.
</ResponseField>

<ResponseField name="recent_payments" type="object[]">
  Newest wallet top-ups.
</ResponseField>

<ResponseField name="recent_transactions" type="object[]">
  Newest wallet transactions.
</ResponseField>

<ResponseField name="month_usage" type="object">
  Aggregated usage for the current billing month.
</ResponseField>

## Example

```bash theme={null}
curl -H "Authorization: Bearer eyJhbGciOi..." \
  https://ariacompute.com/api/billing/summary
```

```json theme={null}
{
  "wallet": { "balance": 42.10, "currency": "USD" },
  "recent_payments": [
    { "id": "pay_01H...", "amount": 20, "currency": "USD", "status": "paid" }
  ],
  "recent_transactions": [
    { "id": "txn_01H...", "type": "usage", "amount": -0.12, "currency": "USD" }
  ],
  "month_usage": { "total_cost": 7.90, "currency": "USD" }
}
```

## Errors

| Status | Meaning                           |
| ------ | --------------------------------- |
| `401`  | Missing or invalid session token. |


## Related topics

- [GET /api/billing/wallet — current wallet balance](/api-reference/billing/wallet.md)
- [GET /api/billing/transactions — wallet transaction history](/api-reference/billing/transactions.md)
- [GET /api/billing/payments — list wallet top-ups](/api-reference/billing/payments-list.md)
- [Prepaid wallet, top-ups, and usage billing](/concepts/wallet-billing.md)
- [GET /api/billing/payments/{id} — get payment status](/api-reference/billing/payments-get.md)