---
title: "List Server Wallets"
method: GET
path: "/v1/wallets/server"
tags: ["Wallets"]
---

# List Server Wallets

`GET /v1/wallets/server`

Get all server wallet details with pagination for your project.

**Authentication**: This endpoint requires backend authentication using the `x-secret-key` header. The secret key should never be exposed publicly.

## Query parameters

- `limit` number
- `page` number

## Response `200`

Returns a list of server wallet addresses, smart wallet addresses, and auth details.

- object
  - `result` object, required
    - `pagination` object, required — Pagination information
      - `hasMore` boolean — Whether there are more items available
      - `limit` number, nullable — Number of items per page
      - `page` number, nullable — Current page number
      - `totalCount` number, nullable — Total number of items available
    - `wallets` object[], required — Array of server wallets
      - `userId` string — Unique identifier for the user wallet within the thirdweb auth system.
      - `address` string — The EOA (Externally Owned Wallet) address of the wallet. This is the traditional wallet address.
      - `createdAt` string — The date and time the wallet was created
      - `profiles` union[], required — The profiles linked to the wallet, can be email, phone, google etc, or backend for developer created wallets
        - union — Authentication provider details with type-based discrimination
          - object — Google OAuth authentication provider details
            - `email` string, required
            - `emailVerified` boolean, required
            - `familyName` string
            - `givenName` string
            - `hd` string, required
            - `id` string, required
            - `locale` string, required
            - `name` string
            - `picture` string, required
            - `type` 'google', required
          - object — Facebook OAuth authentication provider details
            - `email` string
            - `firstName` string
            - `id` string, required
            - `lastName` string
            - `name` string
            - `picture` string
            - `type` 'facebook', required
          - object — Apple OAuth authentication provider details
            - `email` string
            - `emailVerified` boolean, required
            - `id` string, required
            - `isPrivateEmail` boolean, required
            - `type` 'apple', required
          - object — GitHub OAuth authentication provider details
            - `avatar` string, nullable
            - `id` string, required
            - `name` string, nullable
            - `type` 'github', required
            - `username` string, required
          - object — Discord OAuth authentication provider details
            - `avatar` string, required
            - `email` string, email
            - `emailVerified` boolean, required
            - `id` string, required
            - `type` 'discord', required
            - `username` string, required
          - object — Coinbase OAuth authentication provider details
            - `avatar` string
            - `id` string, required
            - `name` string, required
            - `type` 'coinbase', required
          - object — X (Twitter) OAuth authentication provider details
            - `id` string, required
            - `name` string, required
            - `type` 'x', required
            - `username` string, required
            - `profileImageUrl` string
          - object — TikTok OAuth authentication provider details
            - `id` string, required
            - `displayName` string, required
            - `avatarUrl` string, required
            - `unionId` string
            - `type` 'tiktok', required
          - object — Epic Games OAuth authentication provider details
            - `id` string, required
            - `type` 'epic', required
            - `displayName` string
            - `email` string, email
            - `emailVerified` boolean
            - `metadata` object, required
              - …
          - object — Steam OAuth authentication provider details
            - `avatar` string
            - `id` string, required
            - `metadata` object, required
              - …
            - `type` 'steam', required
            - `username` string
          - object — Telegram OAuth authentication provider details
            - `firstName` string
            - `id` string, required
            - `lastName` string
            - `picture` string
            - `type` 'telegram', required
            - `username` string
          - object — Twitch OAuth authentication provider details
            - `avatar` string
            - `description` string
            - `email` string
            - `id` string, required
            - `type` 'twitch', required
            - `username` string, required
          - object — LINE OAuth authentication provider details
            - `avatar` string
            - `id` string, required
            - `type` 'line', required
            - `username` string
          - object — Farcaster authentication provider details
            - `fid` string, required
            - `id` string, required
            - `type` 'farcaster', required
            - `walletAddress` string
          - object — Passkey authentication provider details
            - `algorithm` string, required
            - `credentialId` string, required
            - `publicKey` string, required
            - `type` 'passkey', required
          - object — Email authentication provider details
            - `email` string, email, required
            - `id` string, required
            - `type` 'email', required
          - object — Pre-generated wallet authentication provider details
            - `id` string, required
            - `pregeneratedIdentifier` string, required
            - `type` 'pre_generation', required
          - object — Phone authentication provider details
            - `id` string, required
            - `phone` string, required
            - `type` 'phone', required
          - object — Sign-In with Ethereum (SIWE) authentication provider details
            - `id` string, required
            - `type` 'siwe', required
            - `walletAddress` string, required
          - object — Guest authentication provider details
            - `id` string, required
            - `type` 'guest', required
          - object — Backend authentication provider details (deprecated, use server instead)
            - `id` string, required
            - `type` 'backend', required
          - object — Server authentication provider details
            - `identifier` string, required
            - `type` 'server', required
          - object — Custom JWT authentication provider details
            - `authProviderId` string
            - `email` string
            - `id` string, required
            - `phone` string
            - `type` 'custom_jwt', required
            - `walletAddress` string
          - object — Custom auth endpoint authentication provider details
            - `authProviderId` string
            - `email` string
            - `id` string, required
            - `phone` string
            - `type` 'custom_auth_endpoint', required
            - `walletAddress` string
      - `smartWalletAddress` string — The smart wallet address with EIP-4337 support. This address enables gasless transactions and advanced wallet features.
      - `publicKey` string — The wallet's public key in hexadecimal format. Useful for peer-to-peer encryption and cryptographic operations.

## Other responses

- `401` — Authentication required. The request must include a valid `x-secret-key` header for backend authentication.
- `500` — Internal server error. This may occur due to service unavailability or unexpected server errors.

---

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