> ## 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.

# List wallet transactions

> Retrieve a paginated list of wallet transactions for a workspace. Filter by date range and transaction type for billing reconciliation.

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

<ParamField query="limit" type="integer" default="20">
  Max transactions to return per page (1-100).
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Offset for pagination.
</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>

<ParamField query="type" type="string">
  Filter by transaction type: `topup`, `usage`, `refund`, or `adjustment`.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.nedzo.ai/v1/workspaces/19c3b12f-ec54-43ad-8686-00e921f1befd/billing/transactions?limit=20&offset=0&type=adjustment" \
      -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "items": [
      {
        "id": "c4e5b6d7-1234-5678-9abc-def012345678",
        "type": "adjustment",
        "amount": 2500,
        "balanceAfter": 7500,
        "description": "Manual credit: Customer goodwill credit",
        "createdAt": "2026-04-17T10:30:00Z"
      },
      {
        "id": "d5f6a7b8-2345-6789-abcd-ef0123456789",
        "type": "adjustment",
        "amount": -1000,
        "balanceAfter": 6500,
        "description": "Manual debit: Chargeback correction",
        "createdAt": "2026-04-17T10:35:00Z"
      }
    ],
    "total": 2,
    "limit": 20,
    "offset": 0,
    "hasMore": false
  }
  ```
</ResponseExample>