---
title: "List wallets"
method: GET
path: "/api/wallets"
tags: ["Wallets"]
---

# List wallets

`GET /api/wallets`

List wallets, optionally filtered by customer or status.

## Query parameters

- `customerId` string
- `status` 'ACTIVE' | 'TERMINATED'
- `page` number
- `limit` number

## Response `200`

Paginated list of wallets

- PaginatedWalletResponse
  - `data` WalletResponse[], required
    - `id` string, required
    - `customerId` string, required
    - `name` string
    - `currency` string, required
    - `rateAmount` string, required — 1 credit = rateAmount in currency
    - `creditsBalance` string, required — Available credits
    - `balance` string, required — Monetary equivalent of credits
    - `consumedCredits` string, required — Lifetime consumed credits
    - `consumedAmount` string, required — Lifetime consumed amount
    - `status` 'ACTIVE' | 'TERMINATED', required
    - `expirationAt` string
    - `terminatedAt` string
    - `customer` WalletCustomerResponse
      - `id` string, required
      - `name` string, required
      - `email` string, required
    - `metadata` object
    - `createdAt` string, required
    - `updatedAt` string, required
  - `meta` PaginationMeta, required
    - `total` number, required
    - `page` number, required
    - `limit` number, required
    - `totalPages` number, required

---

[API](https://skmtc.net/novabilling/apis/novabilling-api.md) · [All operations](https://skmtc.net/novabilling/apis/novabilling-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novabilling/novabilling-api/versions/0e449a4e0dc8/schema)