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>",
          "chain_type": "ethereum",
          "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

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.