---
title: "List of transactions"
method: POST
path: "/spacemesh.v2alpha1.TransactionService/List"
tags: ["TransactionService"]
---

# List of transactions

`POST /spacemesh.v2alpha1.TransactionService/List`

## Request

- Base URL: `https://testnet-api.spacemesh.network`
- URL: `https://testnet-api.spacemesh.network/spacemesh.v2alpha1.TransactionService/List`
- Auth: none declared
- TypeScript: <https://skmtc.dev/spacemesh/apis/spacemesh-api/docs/spacemesh.v2alpha1.TransactionService/List/post.ts> (a function with typed inputs; its response is checked against the schema)

List is a method that takes a "TransactionRequest" body and returns an "TransactionList".
This method is used to retrieve a list of transactions based on the provided request parameters.

## Request body

- Spacemeshv2alpha1TransactionRequest
  - `address` string
  - `endLayer` integer: Ending layer for transactions.
  - `includeResult` boolean: Whether to include result of transactions in response.
  - `includeState` boolean: Whether to include transaction state in response.
  - `limit` string, uint64: Specifies maximum number of items to fetch.
  - `offset` string, uint64: Adjusts the starting point for data retrieval.
  - `sortOrder` 'ASC' | 'DESC'
  - `startLayer` integer: Starting layer for transactions.
  - `txid` string[]: Filter: specific transaction IDs to filter.

## Response `200`

A successful response.

- Spacemeshv2alpha1TransactionList
  - `transactions` Spacemeshv2alpha1TransactionResponse[]
    - `tx` Spacemeshv2alpha1Transaction: An immutable Spacemesh transaction. do not include mutable data such as tx state or result.
      - `contents` Spacemeshv2alpha1TransactionContents
        - `drainVault` Spacemeshv2alpha1ContentsDrainVault
          - `amount` string, uint64
          - `destination` string
          - `vault` string
        - `multiSigSpawn` Spacemeshv2alpha1ContentsMultiSigSpawn
          - `pubkey` string[]
          - `required` integer
        - `send` Spacemeshv2alpha1ContentsSend
          - `amount` string, uint64
          - `destination` string
        - `singleSigSpawn` Spacemeshv2alpha1ContentsSingleSigSpawn
          - `pubkey` string
        - `vaultSpawn` Spacemeshv2alpha1ContentsVaultSpawn
          - `initialUnlockAmount` string, uint64
          - `owner` string
          - `totalAmount` string, uint64
          - `vestingEnd` integer
          - `vestingStart` integer
        - `vestingSpawn` Spacemeshv2alpha1ContentsMultiSigSpawn
          - `pubkey` string[]
          - `required` integer
      - `gasPrice` string, uint64
      - `id` string, byte
      - `maxGas` string, uint64
      - `maxSpend` string, uint64
      - `method` integer: this is actually limited by uint8, but no type for that.
      - `nonce` Spacemeshv2alpha1Nonce
        - `counter` string, uint64
      - `principal` string
      - `raw` string, byte
      - `template` string
      - `type` 'TRANSACTION_TYPE_UNSPECIFIED' | 'TRANSACTION_TYPE_SINGLE_SIG_SEND' | 'TRANSACTION_TYPE_SINGLE_SIG_SPAWN' | 'TRANSACTION_TYPE_SINGLE_SIG_SELFSPAWN' | 'TRANSACTION_TYPE_MULTI_SIG_SEND' | 'TRANSACTION_TYPE_MULTI_SIG_SPAWN' | 'TRANSACTION_TYPE_MULTI_SIG_SELFSPAWN' | 'TRANSACTION_TYPE_VESTING_SPAWN' | 'TRANSACTION_TYPE_VAULT_SPAWN' | 'TRANSACTION_TYPE_DRAIN_VAULT'
    - `txResult` Spacemeshv2alpha1TransactionResult
      - `block` string, byte
      - `fee` string, uint64
      - `gasConsumed` string, uint64
      - `layer` integer
      - `message` string
      - `status` 'TRANSACTION_STATUS_UNSPECIFIED' | 'TRANSACTION_STATUS_SUCCESS' | 'TRANSACTION_STATUS_FAILURE' | 'TRANSACTION_STATUS_INVALID'
      - `touchedAddresses` string[]
    - `txState` 'TRANSACTION_STATE_UNSPECIFIED' | 'TRANSACTION_STATE_REJECTED' | 'TRANSACTION_STATE_INSUFFICIENT_FUNDS' | 'TRANSACTION_STATE_CONFLICTING' | 'TRANSACTION_STATE_MEMPOOL' | 'TRANSACTION_STATE_MESH' | 'TRANSACTION_STATE_PROCESSED' | 'TRANSACTION_STATE_INEFFECTUAL': TransactionState is the "journey" of a tx from mempool to block inclusion to mesh to STF processing. To know whether or not the tx actually succeeded, and its side effects, check tx_state. - TRANSACTION_STATE_UNSPECIFIED: default state - TRANSACTION_STATE_REJECTED: rejected from mempool due to, e.g., invalid syntax - TRANSACTION_STATE_INSUFFICIENT_FUNDS: rejected from mempool by funds check - TRANSACTION_STATE_CONFLICTING: rejected from mempool due to conflicting counter - TRANSACTION_STATE_MEMPOOL: in mempool but not on the mesh yet - TRANSACTION_STATE_MESH: submitted to the mesh - TRANSACTION_STATE_PROCESSED: processed by STF; check Receipt for success or failure - TRANSACTION_STATE_INEFFECTUAL: removed from mempool and will be forgotten and never executed

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/spacemesh/apis/spacemesh-api.md) - [All operations](https://skmtc.dev/spacemesh/apis/spacemesh-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spacemesh/apis/spacemesh-api/revisions/427c8b53574b?raw)