---
title: "List accounts"
method: GET
path: "/v1/accounts"
tags: ["Accounts"]
---

# List accounts

`GET /v1/accounts`

List all accounts in your app.

## Query parameters

- `cursor` string
- `limit` number, nullable
- `search` string — Optional search term to filter accounts by display name, account ID, or wallet address.

## Headers

- `privy-app-id` string, required — ID of your Privy app.

## Response `200`

Paginated list of accounts.

- AccountsListResponse — Paginated list of digital asset accounts.
  - `data` AccountResponse[], required — The list of accounts.
    - `display_name` string, nullable, required — An optional display name for the account.
    - `id` string, required — The account ID.
    - `wallets` AccountWallet[], required — The wallets belonging to this account.
      - `address` string, required — The on-chain address of the wallet.
      - `chain_type` 'ethereum' | 'solana', required — The wallet chain types that offer first class support.
      - `custody` WalletCustodian — Information about the custodian managing this wallet.
        - `provider` string, required — The custodian responsible for the wallet.
        - `provider_user_id` string, required — The resource ID of the beneficiary of the custodial wallet.
      - `id` string, required — The wallet ID.
  - `next_cursor` string, nullable, required — Cursor for fetching the next page of results, or null if no more results.

---

[API](https://skmtc.net/privy-io/apis/privy-api.md) · [All operations](https://skmtc.net/privy-io/apis/privy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)