---
title: "List transactions"
method: GET
path: "/api/v1/transactions"
tags: ["transactions"]
---

# List transactions

`GET /api/v1/transactions`

Lists transactions on the network. This includes successful and unsuccessful transactions.

## Query parameters

- `account.id` string
- `limit` integer
- `order` 'asc' | 'desc'
- `timestamp` string[]
- `transactiontype` 'ATOMICBATCH' | 'CONSENSUSCREATETOPIC' | 'CONSENSUSDELETETOPIC' | 'CONSENSUSSUBMITMESSAGE' | 'CONSENSUSUPDATETOPIC' | 'CONTRACTCALL' | 'CONTRACTCREATEINSTANCE' | 'CONTRACTDELETEINSTANCE' | 'CONTRACTUPDATEINSTANCE' | 'CRYPTOADDLIVEHASH' | 'CRYPTOAPPROVEALLOWANCE' | 'CRYPTOCREATEACCOUNT' | 'CRYPTODELETE' | 'CRYPTODELETEALLOWANCE' | 'CRYPTODELETELIVEHASH' | 'CRYPTOTRANSFER' | 'CRYPTOUPDATEACCOUNT' | 'ETHEREUMTRANSACTION' | 'FILEAPPEND' | 'FILECREATE' | 'FILEDELETE' | 'FILEUPDATE' | 'FREEZE' | 'LAMBDASSTORE' | 'NODECREATE' | 'NODEDELETE' | 'NODESTAKEUPDATE' | 'NODEUPDATE' | 'SCHEDULECREATE' | 'SCHEDULEDELETE' | 'SCHEDULESIGN' | 'SYSTEMDELETE' | 'SYSTEMUNDELETE' | 'TOKENAIRDROP' | 'TOKENASSOCIATE' | 'TOKENBURN' | 'TOKENCANCELAIRDROP' | 'TOKENCLAIMAIRDROP' | 'TOKENCREATION' | 'TOKENDELETION' | 'TOKENDISSOCIATE' | 'TOKENFEESCHEDULEUPDATE' | 'TOKENFREEZE' | 'TOKENGRANTKYC' | 'TOKENMINT' | 'TOKENPAUSE' | 'TOKENREJECT' | 'TOKENREVOKEKYC' | 'TOKENUNFREEZE' | 'TOKENUNPAUSE' | 'TOKENUPDATE' | 'TOKENUPDATENFTS' | 'TOKENWIPE' | 'UNCHECKEDSUBMIT' | 'UTILPRNG'
- `result` 'success' | 'fail'
- `type` 'credit' | 'debit'

## Response `200`

OK

- TransactionsResponse
  - `transactions` Transaction[]
    - `batch_key` Key, nullable — The public key which controls access to various network entities.
      - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
      - `key` string
    - `bytes` string, byte, nullable
    - `charged_tx_fee` integer
    - `consensus_timestamp` string — A Unix timestamp in seconds.nanoseconds format
    - `entity_id` string, nullable — Network entity ID in the format of `shard.realm.num`
    - `max_custom_fees` CustomFeeLimit[]
      - `account_id` string, nullable — Network entity ID in the format of `shard.realm.num`
      - `amount` integer
      - `denominating_token_id` string, nullable — Network entity ID in the format of `shard.realm.num`
    - `max_fee` string
    - `memo_base64` string, byte, nullable
    - `name` 'ATOMICBATCH' | 'CONSENSUSCREATETOPIC' | 'CONSENSUSDELETETOPIC' | 'CONSENSUSSUBMITMESSAGE' | 'CONSENSUSUPDATETOPIC' | 'CONTRACTCALL' | 'CONTRACTCREATEINSTANCE' | 'CONTRACTDELETEINSTANCE' | 'CONTRACTUPDATEINSTANCE' | 'CRYPTOADDLIVEHASH' | 'CRYPTOAPPROVEALLOWANCE' | 'CRYPTOCREATEACCOUNT' | 'CRYPTODELETE' | 'CRYPTODELETEALLOWANCE' | 'CRYPTODELETELIVEHASH' | 'CRYPTOTRANSFER' | 'CRYPTOUPDATEACCOUNT' | 'ETHEREUMTRANSACTION' | 'FILEAPPEND' | 'FILECREATE' | 'FILEDELETE' | 'FILEUPDATE' | 'FREEZE' | 'LAMBDASSTORE' | 'NODECREATE' | 'NODEDELETE' | 'NODESTAKEUPDATE' | 'NODEUPDATE' | 'SCHEDULECREATE' | 'SCHEDULEDELETE' | 'SCHEDULESIGN' | 'SYSTEMDELETE' | 'SYSTEMUNDELETE' | 'TOKENAIRDROP' | 'TOKENASSOCIATE' | 'TOKENBURN' | 'TOKENCANCELAIRDROP' | 'TOKENCLAIMAIRDROP' | 'TOKENCREATION' | 'TOKENDELETION' | 'TOKENDISSOCIATE' | 'TOKENFEESCHEDULEUPDATE' | 'TOKENFREEZE' | 'TOKENGRANTKYC' | 'TOKENMINT' | 'TOKENPAUSE' | 'TOKENREJECT' | 'TOKENREVOKEKYC' | 'TOKENUNFREEZE' | 'TOKENUNPAUSE' | 'TOKENUPDATE' | 'TOKENUPDATENFTS' | 'TOKENWIPE' | 'UNCHECKEDSUBMIT' | 'UTILPRNG'
    - `nft_transfers` object[]
      - `is_approval` boolean, required
      - `receiver_account_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `sender_account_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `serial_number` integer, required
      - `token_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
    - `node` string, nullable — Network entity ID in the format of `shard.realm.num`
    - `nonce` integer
    - `parent_consensus_timestamp` string, nullable — A Unix timestamp in seconds.nanoseconds format
    - `result` string
    - `scheduled` boolean
    - `staking_reward_transfers` StakingRewardTransfer[]
      - `account` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `amount` integer, required — The number of tinybars awarded
    - `token_transfers` object[]
      - `token_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `account` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `amount` integer, required
      - `is_approval` boolean
    - `transaction_hash` string, byte
    - `transaction_id` string
    - `transfers` object[]
      - `account` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `amount` integer, required
      - `is_approval` boolean
    - `valid_duration_seconds` string
    - `valid_start_timestamp` string — A Unix timestamp in seconds.nanoseconds format
  - `links` Links
    - `next` string, nullable

## Other responses

- `400` — Invalid parameter

## Changes

- **2025-12-24** (v1) `f1ab65a800ac` — 1 warning, 1 info
  - added the new `LAMBDASSTORE` enum value to the `transactions/items/name` response property for the response status `200`
  - added the new enum value `LAMBDASSTORE` to the `query` request parameter `transactiontype`
- **2025-11-17** (v1) `b710de452fd3` — 2 breaking, 2 info
  - removed the enum value `NODE` from the `query` request parameter `transactiontype`
  - removed the enum value `UNKNOWN` from the `query` request parameter `transactiontype`
  - removed the `NODE` enum value from the `transactions/items/name` response property for the response status `200`
  - removed the `UNKNOWN` enum value from the `transactions/items/name` response property for the response status `200`
- **2025-08-08** (v1) `db389f03b097` — 32 breaking, 4 warning, 16 info
  - removed the enum value `CRSPUBLICATION` from the `query` request parameter `transactiontype`
  - removed the enum value `HINTSKEYPUBLICATION` from the `query` request parameter `transactiontype`
  - removed the enum value `HINTSPARTIALSIGNATURE` from the `query` request parameter `transactiontype`
  - removed the enum value `HINTSPREPROCESSINGVOTE` from the `query` request parameter `transactiontype`
  - …48 more

[Change history](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/changes/api/v1/transactions/get.md)

---

[API](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api.md) · [All operations](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hiero-ledger/mirror-node-rest-api/revisions/69933cd62c21/schema)