---
title: "List wallets"
method: GET
path: "/api/ai-credits/wallets"
tags: ["AI credit client wallets"]
---

# List wallets

`GET /api/ai-credits/wallets`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/ai-credits/wallets`
- Auth: HTTP basic

Your wallets, newest first; deleted wallets never appear. Page with limit (default 100, max 500) and cursor, passing back the next_page of the previous response; next_page is null once a page comes back with fewer than limit wallets. With account_name, only the wallet that client draws from - one result or none, never an error. Errors: invalid_value.

## Query parameters

- `account_name` string
- `cursor` string
- `limit` integer

## Response `200`

OK

- CursorPageResponseApiSubWalletResponse
  - `cursor` string, nullable: Cursor provided in request
  - `limit` integer: Paging limit evaluated for request
  - `next_page` string, nullable: Cursor value for querying next page
  - `results` ApiSubWalletResponse[]: Entities of requested page
    - `assigned_accounts` ApiAccountRefInfo[]: The client accounts drawing from this wallet, empty when none is. Moved by assign and unassign.
      - `account_name` string: The client's account name, as the Accounts API returns it.
    - `created_at` string, date-time
    - `id` string: Minted by Duda and immutable. Store it against your own customer record.
    - `name` string: The id when no name was set.
    - `recurrence_amount` string: The recurring allowance, as a decimal string.
    - `recurrence_balance` string: What is left of the recurring allowance this cycle, as a decimal string. Moved by POST /credits.
    - `recurrence_day` integer: Day of the month (1-31) the cycle turns over. Clamps to the month's length.
    - `topup_balance` string: A single flat top-up figure, as a decimal string. It never expires.
    - `updated_at` string, date-time
  - `site_name` string: Owning site
  - `total_responses` integer: Total number of entities in for given query

## Other responses

- `400`: Bad request. The request is malformed or failed validation.
- `401`: Unauthorized. The credentials are missing or invalid.
- `429`: Too many requests. The rate limit was exceeded.

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)