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

# List Wallets

> Retrieve a paginated list of all provisioned wallets.

## Request Headers

<ParamField header="x-api-key" type="string" required>
  Your live or test API key.
</ParamField>

## Query Parameters

<ParamField query="status" type="string">
  Filter by wallet status (`ACTIVE`, `FROZEN`, `CLOSED`).
</ParamField>

<ParamField query="customer_reference" type="string">
  Filter by a specific customer reference.
</ParamField>

<ParamField query="page" type="integer" default="1">
  The page number to retrieve.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Number of results per page (max 100).
</ParamField>

## Response

<Note>
  All amounts and balances in this endpoint are represented in **kobo** (e.g., `500000` = ₦5,000.00). Ensure you do not send or expect Naira values.
</Note>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "items": [
        {
          "id": "e4b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
          "customer_reference": "user_987",
          "first_name": "John",
          "last_name": "Doe",
          "email": "john.doe@example.com",
          "label": "John Doe — School Fees",
          "account_number": "2211334455",
          "bank_name": "Nomba MFB",
          "account_name": "PropTech Inc / John Doe",
          "balance": 1500000,
          "currency": "NGN",
          "status": "ACTIVE",
          "system_prompt": "This wallet collects school fees...",
          "allow_transfers_out": true,
          "sub_account_id": null,
          "created_at": "2026-07-01T11:00:00Z"
        }
      ],
      "total": 45,
      "page": 1,
      "limit": 20
    }
  }
  ```
</ResponseExample>