> ## 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.

# Get wallets

> Get all wallets in your app.

### SDK methods

Learn more about getting wallets using our SDKs [here](/wallets/wallets/get-a-wallet/get-all-wallets).


## OpenAPI

````yaml get /v1/wallets
openapi: 3.1.0
info:
  version: 0.0.1
  title: Privy API
  description: >-
    REST API for Privy's wallet infrastructure — provision and manage wallets
    across EVM, Solana, and Bitcoin, authenticate users, sign transactions, and
    configure programmable policies and authorization intents.
  contact:
    name: Privy
    url: https://www.privy.io/
    email: support@privy.io
servers:
  - url: https://api.privy.io
security: []
tags:
  - name: Accounts
    description: Operations related to asset accounts
  - name: Actions
    description: Operations related to looking up wallet actions across an app
  - name: Aggregations
    description: Operations related to aggregations for tracking and measuring metrics
  - name: Apps
    description: Operations related to app settings and allowlist management
  - name: Cards
    description: Operations related to stablecoin-backed card issuing
  - name: Client Auth
    description: OAuth token exchange and device authorization operations
  - name: Condition Sets
    description: Operations related to condition sets
  - name: Embedded wallets
    description: Operations related to embedded wallet creation and authentication
  - name: Fiat
    description: Operations related to fiat onramping and offramping
  - name: Intents
    description: Operations related to authorization intents for wallet actions
  - name: Key quorums
    description: Operations related to key quorums
  - name: Kraken Embed
    description: >-
      Operations for Kraken Embed integration, including quotes, trades, user
      management, and portfolio operations
  - name: OAuth
    description: >-
      OAuth 2.0 endpoints including Device Authorization Grant (RFC 8628) for
      CLI and limited-input device login flows
  - name: Organizations
    description: Operations related to organizations
  - name: Policies
    description: Operations related to policies
  - name: Shared
    description: Common schemas shared across resources
  - name: Swaps
    description: Operations for swapping tokens within wallets
  - name: Teams
    description: Operations related to dashboard team management
  - name: Transactions
    description: Operations related to transactions
  - name: User signers
    description: Operations related to user signers
  - name: Users
    description: Operations related to users
  - name: Wallet Actions
    description: Operations related to wallet actions
  - name: Wallet Automations
    description: Operations related to wallet automations
  - name: Wallets
    description: Operations related to wallets
  - name: Webhooks
    description: >-
      Webhook events that Privy sends to your configured endpoint when specific
      actions occur in your app
  - name: Yield
    description: >-
      Operations for depositing and withdrawing funds from ERC-4626 yield vaults
      (Morpho, Aave)
paths:
  /v1/wallets:
    get:
      tags:
        - Wallets
      summary: Get all wallets
      description: Get all wallets in your app.
      operationId: listWallets
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 512
            description: Cursor returned by the previous page.
          required: false
          name: cursor
          in: query
        - schema:
            type:
              - number
              - 'null'
            maximum: 100
          required: false
          name: limit
          in: query
        - schema:
            $ref: '#/components/schemas/WalletChainType'
          required: false
          name: chain_type
          in: query
        - schema:
            $ref: '#/components/schemas/Address'
          required: false
          name: address
          in: query
        - schema:
            type: string
            description: >-
              Filter wallets by user ID. Cannot be used together with
              authorization_key.
          required: false
          name: user_id
          in: query
        - schema:
            type: string
            description: Filter wallets by the entity ID the wallet is attributed to.
          required: false
          name: entity_id
          in: query
        - schema:
            type: string
            maxLength: 250
            pattern: ^[A-Za-z0-9+/=\-\s]+$
            description: >-
              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.
          required: false
          name: authorization_key
          in: query
        - schema:
            type: string
            description: Filter wallets by external ID.
          required: false
          name: external_id
          in: query
        - schema:
            type: boolean
            description: Include archived wallets in lookup. Defaults to false.
          required: false
          name: include_archived
          in: query
        - schema:
            type: string
            description: ID of your Privy app.
          required: true
          name: privy-app-id
          in: header
      responses:
        '200':
          description: Object with wallet data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Wallet'
                  next_cursor:
                    type: string
                required:
                  - data
      security:
        - appSecretAuth: []
components:
  schemas:
    WalletChainType:
      type: string
      enum:
        - ethereum
        - solana
        - cosmos
        - stellar
        - sui
        - aptos
        - movement
        - tron
        - bitcoin-segwit
        - bitcoin-taproot
        - pearl
        - near
        - ton
        - starknet
        - xrpl
        - spark
      description: The wallet chain types.
      title: WalletChainType
      x-stainless-model: wallets.wallet_chain_type
    Address:
      anyOf:
        - type: string
        - type: string
        - type: string
          minLength: 20
          maxLength: 128
      description: >-
        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.
      title: Address
      x-stainless-model: wallets.address
    Wallet:
      type: object
      properties:
        id:
          type: string
          description: >-
            Unique ID of the wallet. This will be the primary identifier when
            using the wallet in the future.
        address:
          type: string
          description: Address of the wallet.
        display_name:
          type: string
          description: A human-readable label for the wallet.
        external_id:
          type: string
          maxLength: 64
          pattern: ^[a-zA-Z0-9_-]+$
          description: >-
            A customer-provided identifier for mapping to external systems.
            URL-safe characters only ([a-zA-Z0-9_-]), max 64 chars. Write-once:
            cannot be changed once set.
        public_key:
          type: string
          description: >-
            The compressed, raw public key for the wallet along the chain
            cryptographic curve.
        created_at:
          type: number
          description: Unix timestamp of when the wallet was created in milliseconds.
        chain_type:
          $ref: '#/components/schemas/WalletChainType'
        policy_ids:
          type: array
          items:
            type: string
          description: List of policy IDs for policies that are enforced on the wallet.
        owner_id:
          type:
            - string
            - 'null'
          format: cuid2
          description: The key quorum ID of the owner of the wallet.
        entity:
          default: null
          description: The entity the wallet is attributed to.
          anyOf:
            - $ref: '#/components/schemas/WalletEntity'
            - type: 'null'
        additional_signers:
          $ref: '#/components/schemas/WalletAdditionalSigner'
        exported_at:
          type:
            - number
            - 'null'
          description: >-
            Unix timestamp of when the wallet was exported in milliseconds, if
            the wallet was exported.
        imported_at:
          type:
            - number
            - 'null'
          description: >-
            Unix timestamp of when the wallet was imported in milliseconds, if
            the wallet was imported.
        authorization_threshold:
          type: number
          description: The number of keys that must sign for an action to be valid.
        automations:
          type: array
          items:
            $ref: '#/components/schemas/AttachedWalletAutomation'
          description: Automations attached to the wallet, including disabled ones.
        archived_at:
          type:
            - number
            - 'null'
          default: null
          description: >-
            Unix timestamp of when the wallet was archived in milliseconds, or
            null if the wallet is active.
        chain:
          allOf:
            - $ref: '#/components/schemas/CustodialWalletChain'
            - description: The chain of this wallet, only present for custodial wallets.
        custody:
          $ref: '#/components/schemas/WalletCustodian'
      required:
        - id
        - address
        - created_at
        - chain_type
        - policy_ids
        - owner_id
        - additional_signers
        - exported_at
        - imported_at
      description: A wallet managed by Privy's wallet infrastructure.
      title: Wallet
      example:
        id: id2tptkqrxd39qo9j423etij
        address: '0xF1DBff66C993EE895C8cb176c30b07A559d76496'
        display_name: Treasury
        external_id: my-order-123
        chain_type: ethereum
        policy_ids: []
        additional_signers: []
        owner_id: rkiz0ivz254drv1xw982v3jq
        entity:
          id: jorpjo4rfxj62nx1itt8y1zt
          type: user
        created_at: 1741834854578
        exported_at: null
        imported_at: null
        archived_at: null
      x-stainless-model: wallets.wallet
    WalletEntity:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/EntityId'
        type:
          $ref: '#/components/schemas/WalletEntityType'
      required:
        - id
        - type
      additionalProperties: false
      description: The entity a wallet is attributed to.
      title: WalletEntity
      example:
        id: jorpjo4rfxj62nx1itt8y1zt
        type: user
      x-stainless-model: wallets.wallet_entity
    WalletAdditionalSigner:
      type: array
      items:
        $ref: '#/components/schemas/WalletAdditionalSignerItem'
      description: Additional signers for the wallet.
      title: WalletAdditionalSigner
      x-stainless-model: wallets.wallet_additional_signer
    AttachedWalletAutomation:
      type: object
      properties:
        id:
          type: string
          description: ID of the automation.
        enabled:
          type: boolean
          description: >-
            Whether this attachment is currently active — true only if both the
            attachment and the underlying automation are enabled.
      required:
        - id
        - enabled
      additionalProperties: false
      description: A summary of an automation attached to a wallet.
      title: AttachedWalletAutomation
      example:
        id: id2tptkqrxd39qo9j423etij
        enabled: true
      x-stainless-model: wallets.attached_wallet_automation
    CustodialWalletChain:
      type: string
      enum:
        - base
        - solana
        - tempo
      description: The chain of the custodial wallet.
      title: CustodialWalletChain
      example: tempo
      x-stainless-model: wallets.custodial_wallet_chain
    WalletCustodian:
      type: object
      properties:
        provider:
          type: string
          description: The custodian responsible for the wallet.
        provider_user_id:
          type: string
          description: The resource ID of the beneficiary of the custodial wallet.
      required:
        - provider
        - provider_user_id
      description: Information about the custodian managing this wallet.
      title: WalletCustodian
      x-stainless-model: wallets.wallet_custodian
    EntityId:
      type: string
      minLength: 1
      description: A Privy entity ID.
      title: EntityId
      example: jorpjo4rfxj62nx1itt8y1zt
      x-stainless-model: wallets.entity_id
    WalletEntityType:
      type: string
      enum:
        - user
        - organization
      description: The type of entity a wallet is attributed to.
      title: WalletEntityType
      example: user
      x-stainless-model: wallets.wallet_entity_type
    WalletAdditionalSignerItem:
      type: object
      properties:
        signer_id:
          $ref: '#/components/schemas/KeyQuorumId'
        override_policy_ids:
          $ref: '#/components/schemas/PolicyInput'
      required:
        - signer_id
      additionalProperties: false
      description: >-
        A single additional signer on a wallet, with an optional policy
        override.
      title: WalletAdditionalSignerItem
      x-stainless-model: wallets.wallet_additional_signer_item
    KeyQuorumId:
      type: string
      format: cuid2
      description: A unique identifier for a key quorum.
      title: KeyQuorumId
      x-stainless-model: shared.key_quorum_id
    PolicyInput:
      type: array
      items:
        type: string
        minLength: 24
        maxLength: 24
        format: cuid2
      maxItems: 1
      description: An optional list of up to one policy ID to enforce on the wallet.
      title: PolicyInput
      x-stainless-model: wallets.policy_input
  securitySchemes:
    appSecretAuth:
      type: http
      scheme: basic
      description: >-
        Basic Auth header with your app ID as the username and your app secret
        as the password.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.