---
title: "Get transactions list"
method: GET
path: "/v2/transactions"
tags: ["Blockchain transactions"]
---

# Get transactions list

`GET /v2/transactions`

Returns a list of transactions that match the specified search term.

## Query parameters

- `network` string, required
- `cursor` string
- `types` string
- `size` number
- `tx_hash` string
- `address` string
- `status` 'SUCCEEDED' | 'ERROR'
- `start_time` string, date-time
- `end_time` string, date-time

## Response `200`

List of transactions that match the specified search term.

- SearchTransactionsResponseDto
  - `items` TransactionDto[], required
    - `id` string, required
    - `time` string, required
    - `height` string, required
    - `hash` string, required
    - `success` boolean, required
    - `types` string[], required
    - `signers` string[], required
    - `transfers` TransactionTransferDto, required
      - `sender` 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
              - …
          - ContractDetails
            - `network` string
            - `address` string
            - `cosmos_contract` object
              - …
            - `solana_contract` object
              - …
          - 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
              - …
          - AltitudeConnectionDetails
            - `connection_provider` string, required
            - `connection_id` string — Account-connection holding this account
            - `connection_object_id` string, required
            - `altitude` AccountConnectionAltitudePublicDataDto, required
              - …
          - RealmsConnectionDetails
            - `connection_provider` string, required
            - `connection_id` string — Account-connection holding this account
            - `connection_object_id` string, required
            - `realms` AccountConnectionRealmsPublicDataDto, required
              - …
          - SafeConnectionDetails
            - `connection_provider` string, required
            - `connection_id` string — Account-connection holding this account
            - `connection_object_id` string, required
            - `safe` AccountConnectionSafePublicDataDto, required
              - …
          - 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
      - `receiver` 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
              - …
          - ContractDetails
            - `network` string
            - `address` string
            - `cosmos_contract` object
              - …
            - `solana_contract` object
              - …
          - 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
              - …
          - AltitudeConnectionDetails
            - `connection_provider` string, required
            - `connection_id` string — Account-connection holding this account
            - `connection_object_id` string, required
            - `altitude` AccountConnectionAltitudePublicDataDto, required
              - …
          - RealmsConnectionDetails
            - `connection_provider` string, required
            - `connection_id` string — Account-connection holding this account
            - `connection_object_id` string, required
            - `realms` AccountConnectionRealmsPublicDataDto, required
              - …
          - SafeConnectionDetails
            - `connection_provider` string, required
            - `connection_id` string — Account-connection holding this account
            - `connection_object_id` string, required
            - `safe` AccountConnectionSafePublicDataDto, required
              - …
          - 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)