Skip to main content
GET
/
v1
/
accounts
List accounts
curl --request GET \
  --url https://api.privy.io/v1/accounts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'privy-app-id: <privy-app-id>'
{
  "data": [
    {
      "id": "<string>",
      "display_name": "<string>",
      "wallets": [
        {
          "id": "<string>",
          "address": "<string>",
          "custody": {
            "provider": "<string>",
            "provider_user_id": "<string>"
          }
        }
      ]
    }
  ],
  "next_cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.privy.io/llms.txt

Use this file to discover all available pages before exploring further.

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
​
search
string

Optional search term to filter accounts by display name, account ID, or wallet address.

Response

200 - application/json

Paginated list of accounts.

Paginated list of digital asset accounts.

​
data
AccountResponse · object[]
required

The list of accounts.

​
next_cursor
string | null
required

Cursor for fetching the next page of results, or null if no more results.