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

# Get usage summary

> Aggregates wallet transactions across a date range and returns total spend, total top-ups, total refunds, net adjustments, and a per-type breakdown.

<ParamField path="workspaceId" type="string" required>
  Workspace UUID
</ParamField>

<ParamField query="startDate" type="string">
  Inclusive ISO 8601 lower bound on `created_at`.
</ParamField>

<ParamField query="endDate" type="string">
  Exclusive ISO 8601 upper bound on `created_at`.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.nedzo.ai/v1/workspaces/19c3b12f-ec54-43ad-8686-00e921f1befd/billing/usage?startDate=2026-04-01T00:00:00Z&endDate=2026-05-01T00:00:00Z" \
      -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "workspaceId": "19c3b12f-ec54-43ad-8686-00e921f1befd",
    "startDate": "2026-04-01T00:00:00Z",
    "endDate": "2026-05-01T00:00:00Z",
    "currency": "usd",
    "totalSpendCents": 8500,
    "totalTopupCents": 20000,
    "totalRefundCents": 0,
    "totalAdjustmentCents": 1500,
    "byType": {
      "usage": -8500,
      "topup": 20000,
      "refund": 0,
      "adjustment": 1500
    }
  }
  ```
</ResponseExample>