Skip to main content
GET
/
v1
/
wallets
Get all wallets
curl --request GET \
  --url https://api.privy.io/v1/wallets \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'privy-app-id: <privy-app-id>'
{
  "data": [
    {
      "id": "id2tptkqrxd39qo9j423etij",
      "address": "0xF1DBff66C993EE895C8cb176c30b07A559d76496",
      "display_name": "Treasury",
      "external_id": "my-order-123",
      "chain_type": "ethereum",
      "policy_ids": [],
      "additional_signers": [],
      "owner_id": "rkiz0ivz254drv1xw982v3jq",
      "created_at": 1741834854578,
      "exported_at": null,
      "imported_at": null,
      "archived_at": null
    }
  ],
  "next_cursor": "<string>"
}

​
SDK methods

Learn more about getting wallets using our SDKs here.

Authorizations

​
Authorization
string
header
required

Basic Auth header with your app ID as the username and your app secret as the password.

Headers

​
privy-app-id
string
required

ID of your Privy app.

Query Parameters

​
cursor
string
Minimum string length: 1
​
limit
number | null
Required range: x <= 100
​
chain_type
enum<string>

The wallet chain types.

Available options:
ethereum,
solana,
cosmos,
stellar,
sui,
aptos,
movement,
tron,
bitcoin-segwit,
bitcoin-taproot,
pearl,
near,
ton,
starknet,
spark
​
address

A blockchain wallet address. Ethereum addresses are normalized to EIP-55 checksum format. Solana addresses are validated as base58. All other chain addresses (Stellar, Tron, Sui, Aptos, etc.) are accepted as-is.

​
user_id
string

Filter wallets by user ID. Cannot be used together with authorization_key.

​
authorization_key
string

Filter wallets by authorization public key. Returns wallets owned by key quorums that include the specified P-256 public key (base64-encoded DER format). Cannot be used together with user_id.

Maximum string length: 250
Pattern: ^[A-Za-z0-9+/=\-\s]+$
​
external_id
string

Filter wallets by external ID.

​
include_archived
boolean

Include archived wallets in lookup. Defaults to false.

Response

200 - application/json

Object with wallet data.

​
data
Wallet · object[]
required
​
next_cursor
string