Wallets

Fetch Users

From your backend, you can list all your users and fetch the details of any user within your in app or ecosystem wallet. This includes their address, email, phone number, and more.

Get Single User

Fetch details for a specific user by email, phone, wallet address, or user ID.

Query Parameters

You can query by any of these user identifiers:

address: The user's wallet address that thirdweb generated
email: The user's email address
phone: The user's phone number
externalWalletAddress: The user's external wallet address (SIWE login)
id: The user's ID (for custom auth)

Authentication

Required headers:

x-secret-key: Your secret key for authentication
x-ecosystem-id (optional): Your ecosystem ID
x-ecosystem-partner-id (optional): Your ecosystem partner ID

Example

Request

GET

/v1/wallets/user


fetch("https://api.thirdweb.com/v1/wallets/user?limit=50&page=1", {
  method: "GET",
  headers: {
    "x-secret-key": "<your-project-secret-key>",
  },
});

Response


{
  "result": {
    "pagination": {
      "hasMore": true,
      "limit": 20,
      "page": 1
    },
    "wallets": [
      {
        "address": "string",
        "profiles": [
          {
            "email": "string",
            "emailVerified": true,
            "hd": "string",
            "id": "string",
            "locale": "string",
            "picture": "string",
            "type": "google",
            "familyName": "string",
            "givenName": "string",
            "name": "string"
          }
        ],
        "createdAt": "string",
        "smartWalletAddress": "string"
      }
    ]
  }
}

For ecosystem wallets, include the ecosystem headers in your requests.

SDK Integration

If you're using the thirdweb SDK, you can use the getUser method for easier integration:

getUser

Get user details from your backend for thirdweb wallets in TypeScript