---
title: "Get account by address"
method: GET
path: "/v2/accounts/{id}"
tags: ["Accounts"]
---

# Get account by address

`GET /v2/accounts/{id}`

Returns a single account matching the given address for the caller workspace.

## Path parameters

- `id` string, required

## Response `200`

- AccountDto
  - `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
            - `pubkey` string, required
            - `owner` string, required
            - `owner_kind` 'native_treasury' | 'governance', required
            - `mint` string, required
            - `balance` string, required
            - `decimals` number, required
            - `ui_amount` string, 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
            - `owner` string, required
            - `submission_date` string, 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

---

[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)