---
title: "List accounts"
method: GET
path: "/v2/accounts"
tags: ["Accounts"]
---

# List accounts

`GET /v2/accounts`

Returns the list of accounts for the caller workspace.

## Query parameters

- `cursor` string
- `size` number
- `group_id` string
- `type` 'eoa' | 'multisig' | 'contract' | 'custodian' | 'exchange' | 'bank' | 'defi'
- `provider` 'utila' | 'kraken' | 'binance' | 'okx' | 'bybit' | 'bitget' | 'gate' | 'kucoin' | 'plaid' | 'squads' | 'altitude' | 'coinbase' | 'realms' | 'wise' | 'safe' | 'hyperliquid' | 'cubist' | 'privy' | 'dfns' | 'anchorage' | 'revolut_business' | 'turnkey' | 'octav'
- `chain` string
- `connection_id` string

## Response `200`

- SearchAccountsResponseDto
  - `items` AccountDto[], required
    - `id` string, required
    - `name` string, required
    - `type` 'eoa' | 'multisig' | 'contract' | 'custodian' | 'exchange' | 'bank' | 'defi', required
    - `network` string
    - `address` string
    - `provider` string, required
    - `groups` object[], required
      - `id` string
      - `name` string
    - `status` 'active' | 'updating', required
    - `balances` AccountBalance[], required
      - `asset` string, required
      - `amount` string, required — Raw quantity reported by the provider, in asset units.
      - `usd` string, nullable — USD equivalent of `amount`. `null` when no USD price is available. For fiat accounts, equals `amount`.
      - `updated_at` string, required
    - `balances_usd` string, nullable — Total USD value across all of the account balances. `null` when no asset has a known price.
    - `balances_updated_at` string
    - `details` union
      - WalletDetails
        - `network` string, required
        - `address` string, required
        - `funded_by` object
          - `sender` string, required
          - `tx_hash` string, required
          - `tx_time` string, required
      - ContractDetails
        - `network` string
        - `address` string
        - `cosmos_contract` object
          - `admin` string, nullable, required
          - `code_id` number, required
          - `creator` string, required
        - `solana_contract` object
          - `owner` string, required
          - `is_on_curve` boolean, required
          - `space` number, required
          - `executable_data` string, required
          - `upgradeable` boolean, required
          - `upgrade_authority` string, nullable, required
          - `upgrade_authority_type` string, required
          - `last_deployed_slot` number
          - `last_deployed_at` string
          - `last_deployed_by` string
          - `last_deployed_tx` string
          - `verified` boolean, required
          - `repo_url` string
          - `security_txt_included` boolean, required
      - AccountConnectionDetails
        - `connection_provider` string, required
        - `connection_id` string — Account-connection holding this account
        - `connection_object_id` string, required
      - SquadsConnectionDetails
        - `connection_provider` string, required
        - `connection_id` string — Account-connection holding this account
        - `connection_object_id` string, required
        - `multisig` AccountConnectionSquadsPublicDataDto, required
          - `multisig_address` string, required
          - `resolved_from_address` string, required — Original address provided by the customer (may be a vault)
          - `resolved_vault_index` number — Vault index if input was a vault address
          - `threshold` number, required
          - `version` 'v3' | 'v4', required
          - `program_id` string, required
          - `create_key` string, required
          - `config_authority` string, nullable — V4 only
          - `time_lock` number — V4 only — seconds
          - `members` object[], required
          - `pending_proposals` AccountConnectionSquadsPendingProposalDto[], required
            - `address` string, required
            - `transaction_index` number, required
            - `status` 'draft' | 'active' | 'executeReady' | 'approved' | 'executing' | 'executed' | 'rejected' | 'cancelled' | 'unknown', required — V3: draft/active/executeReady/executed/rejected/cancelled. V4 adds: approved/executing.
            - `approved_count` number, required
            - `rejected_count` number, required
            - `approved` string[] — Signer pubkeys that approved (per-signer confirmation). Absent on connections persisted before this field existed, until next refresh.
            - `rejected` string[] — Signer pubkeys that rejected. Absent on connections persisted before this field existed, until next refresh.
            - `timestamp` number, nullable
          - `vaults` object[], required
      - AltitudeConnectionDetails
        - `connection_provider` string, required
        - `connection_id` string — Account-connection holding this account
        - `connection_object_id` string, required
        - `altitude` AccountConnectionAltitudePublicDataDto, required
          - `settings_address` string, required — Settings account of the smart account (the canonical config PDA)
          - `resolved_from_address` string, required — Original address provided by the customer (may be a smart-account deposit address)
          - `resolved_account_index` number — Smart-account index if the input was a smart-account (deposit) address
          - `is_altitude` boolean, required — Whether the smart account is Altitude-managed (Altitude's operational key fee-pays its transactions) vs a generic smart account.
          - `program_id` string, required
          - `settings_seed` string, required — u128 global-counter seed of the Settings PDA
          - `settings_authority` string, nullable — null = autonomous (settings changes go through signers)
          - `threshold` number, required
          - `time_lock` number, required — Seconds
          - `transaction_index` number, required
          - `stale_transaction_index` number, required
          - `signers` object[], required
          - `policies` AccountConnectionAltitudePolicyDto[], required
            - `address` string, required
            - `seed` number, required
          - `policies_truncated` boolean — Present (true) only in the edge case where the account has cycled through more than 2048 policies over its lifetime (the scan cap) — policies with seeds above 2048 are then missing from the list.
          - `pending_proposals` AccountConnectionSquadsPendingProposalDto[], required
            - `address` string, required
            - `transaction_index` number, required
            - `status` 'draft' | 'active' | 'executeReady' | 'approved' | 'executing' | 'executed' | 'rejected' | 'cancelled' | 'unknown', required — V3: draft/active/executeReady/executed/rejected/cancelled. V4 adds: approved/executing.
            - `approved_count` number, required
            - `rejected_count` number, required
            - `approved` string[] — Signer pubkeys that approved (per-signer confirmation). Absent on connections persisted before this field existed, until next refresh.
            - `rejected` string[] — Signer pubkeys that rejected. Absent on connections persisted before this field existed, until next refresh.
            - `timestamp` number, nullable
          - `smart_accounts` AccountConnectionAltitudeSmartAccountDto[], required
            - `account_index` number, required — Smart-account (vault) index
            - `address` string, required
            - `lamports` string, required
            - `token_accounts` object[], required
              - …
      - RealmsConnectionDetails
        - `connection_provider` string, required
        - `connection_id` string — Account-connection holding this account
        - `connection_object_id` string, required
        - `realms` AccountConnectionRealmsPublicDataDto, required
          - `realm_address` string, required
          - `resolved_from_address` string, required
          - `program_id` string, required
          - `version` 'v2', required
          - `realm_name` string, required
          - `community_mint` string, required
          - `council_mint` string, nullable
          - `authority` string, nullable
          - `min_community_weight_to_create_governance` string, required
          - `council_members` object[], required
          - `community_members_count` number, required
          - `governances` object[], required
          - `treasuries` AccountConnectionRealmsTreasuryDto[], required
            - `governance` string, required
            - `native_treasury` string, required
            - `lamports` string, required
            - `token_accounts` AccountConnectionRealmsTokenAccountDto[], required
              - …
          - `latest_active_proposal` AccountConnectionRealmsLatestActiveProposalDto
            - `pubkey` string, required
            - `governance` string, required
            - `governing_token_mint` string, required
            - `track` 'community' | 'council', required
            - `name` string, required
            - `state` string, required
            - `draft_at` number, required
      - SafeConnectionDetails
        - `connection_provider` string, required
        - `connection_id` string — Account-connection holding this account
        - `connection_object_id` string, required
        - `safe` AccountConnectionSafePublicDataDto, required
          - `safe_address` string, required — EIP-55 checksummed Safe address
          - `network` 'ethereum' | 'arbitrum' | 'base' | 'optimism' | 'polygon' | 'bnb', required
          - `version` string, required — Safe contract version (e.g. 1.3.0, 1.4.1)
          - `threshold` number, required
          - `nonce` number, required
          - `owners` string[], required
          - `pending_proposals` AccountConnectionSafePendingProposalDto[], required
            - `safe_tx_hash` string, required
            - `nonce` number, required
            - `destination_address` string, required
            - `value` string, required — Native asset amount, human-readable (raw wei divided by 10^18).
            - `data_payload` string, nullable
            - `operation` number, required — 0 = call, 1 = delegatecall
            - `confirmations_required` number, required
            - `confirmations` AccountConnectionSafeConfirmationDto[], required
              - …
            - `submission_date` string, nullable
      - PrivyConnectionDetails
        - `connection_provider` string, required
        - `connection_id` string — Account-connection holding this account
        - `connection_object_id` string, required
        - `privy_custody` 'app' | 'embedded' | 'external', required — Custody origin of the wallet: app/server-controlled, Privy-managed embedded, or user self-custody (external).
      - DfnsConnectionDetails
        - `connection_provider` string, required
        - `connection_id` string — Account-connection holding this account
        - `connection_object_id` string, required
        - `dfns_custody` 'organization' | 'end_user', required — Custody of the Dfns wallet: owned by the organization (custodial) or delegated to an end user (non-custodial).
    - `notes` string
    - `role` string
  - `meta` CursorMetaDto, required
    - `next_cursor` string, nullable — Opaque string cursor pointing to the next page of results. null if there is no next page.
    - `previous_cursor` string, nullable — Opaque string cursor pointing to the previous page of results. null if there is no previous page.
    - `first_page_cursor` string — Opaque string cursor pointing to the very first page in the entire dataset with respect to the current filter.
    - `last_page_cursor` string, nullable — Opaque string cursor pointing to the very last page in the entire dataset with respect to the current filter.
    - `total_count` number, nullable — Total number of results.
    - `page_number` number — Current page number.

---

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