---
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' | 'HOOKSTORE' | 'LEDGERIDPUBLICATION' | 'NODECREATE' | 'NODEDELETE' | 'NODESTAKEUPDATE' | 'NODEUPDATE' | 'REGISTEREDNODECREATE' | 'REGISTEREDNODEDELETE' | 'REGISTEREDNODEUPDATE' | '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`
    - `high_volume` boolean — Whether the transaction used high-volume entity creation throttles and pricing per HIP-1313
    - `high_volume_pricing_multiplier` integer, nullable — The multiplier applied to the transaction fee when high-volume pricing was in effect per HIP-1313, scaled by 1000 (e.g. 1000 = 1x, 4000 = 4x). A value of 0 means high-volume pricing was not applied. Null for pre-HIP-1313 transactions.
    - `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' | 'HOOKSTORE' | 'LEDGERIDPUBLICATION' | 'NODECREATE' | 'NODEDELETE' | 'NODESTAKEUPDATE' | 'NODEUPDATE' | 'REGISTEREDNODECREATE' | 'REGISTEREDNODEDELETE' | 'REGISTEREDNODEUPDATE' | '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

---

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