Sign in
transactions

List transactions

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

get/api/v1/transactions

Query parameters

account.idstring

The ID of the account to return information for

limitinteger

The maximum number of items to return

order'asc' | 'desc'

The order in which items are listed

timestampstring[]

The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

transactiontype'ATOMICBATCH' | 'CONSENSUSCREATETOPIC' | 'CONSENSUSDELETETOPIC' | 'CONSENSUSSUBMITMESSAGE' | 'CONSENSUSUPDATETOPIC' | 'CONTRACTCALL' | 'CONTRACTCREATEINSTANCE' | 'CONTRACTDELETEINSTANCE' | 'CONTRACTUPDATEINSTANCE' | 'CRSPUBLICATION' | 'CRYPTOADDLIVEHASH' | 'CRYPTOAPPROVEALLOWANCE' | 'CRYPTOCREATEACCOUNT' | 'CRYPTODELETE' | 'CRYPTODELETEALLOWANCE' | 'CRYPTODELETELIVEHASH' | 'CRYPTOTRANSFER' | 'CRYPTOUPDATEACCOUNT' | 'ETHEREUMTRANSACTION' | 'FILEAPPEND' | 'FILECREATE' | 'FILEDELETE' | 'FILEUPDATE' | 'FREEZE' | 'HINTSKEYPUBLICATION' | 'HINTSPARTIALSIGNATURE' | 'HINTSPREPROCESSINGVOTE' | 'HISTORYPROOFKEYPUBLICATION' | 'HISTORYPROOFSIGNATURE' | 'HISTORYPROOFVOTE' | 'HOOKSTORE' | 'LEDGERIDPUBLICATION' | 'MIGRATIONROOTHASHVOTE' | 'NODECREATE' | 'NODEDELETE' | 'NODESTAKEUPDATE' | 'NODEUPDATE' | 'REGISTEREDNODECREATE' | 'REGISTEREDNODEDELETE' | 'REGISTEREDNODEUPDATE' | 'SCHEDULECREATE' | 'SCHEDULEDELETE' | 'SCHEDULESIGN' | 'STATESIGNATURETRANSACTION' | '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'

The transaction success type.

type'credit' | 'debit'

The transaction account balance modification type.

Response

OK

Example response

{
  "transactions": [
    {
      "batch_key": {
        "_type": "ED25519",
        "key": "7934a257a6144fabc8fbdeeaa5810662adb89e7b6978ace46a74fdb2d12bd4b2"
      },
      "bytes": null,
      "charged_tx_fee": 7,
      "consensus_timestamp": "1234567890.000000007",
      "entity_id": "0.0.2281979",
      "high_volume": false,
      "high_volume_pricing_multiplier": 1,
      "max_custom_fees": [
        {
          "account_id": "0.0.8",
          "amount": 1000,
          "denominating_token_id": "0.0.2000"
        },
        {
          "account_id": "0.0.8",
          "amount": 1500,
          "denominating_token_id": null
        }
      ],
      "max_fee": 33,
      "memo_base64": null,
      "name": "CRYPTOTRANSFER",
      "nft_transfers": [
        {
          "is_approval": true,
          "receiver_account_id": "0.0.121",
          "sender_account_id": "0.0.122",
          "serial_number": 1,
          "token_id": "0.0.123"
        },
        {
          "is_approval": true,
          "receiver_account_id": "0.0.321",
          "sender_account_id": "0.0.422",
          "serial_number": 2,
          "token_id": "0.0.123"
        }
      ],
      "node": "0.0.3",
      "nonce": 0,
      "parent_consensus_timestamp": "1234567890.000000007",
      "result": "SUCCESS",
      "scheduled": false,
      "staking_reward_transfers": [
        {
          "account": 3,
          "amount": 150
        },
        {
          "account": 9,
          "amount": 200
        }
      ],
      "transaction_hash": "vigzKe2J7fv4ktHBbNTSzQmKq7Lzdq1/lJMmHT+a2KgvdhAuadlvS4eKeqKjIRmW",
      "transaction_id": "0.0.8-1234567890-000000006",
      "token_transfers": [
        {
          "token_id": "0.0.90000",
          "account": "0.0.9",
          "amount": 1200,
          "is_approval": false
        },
        {
          "token_id": "0.0.90000",
          "account": "0.0.8",
          "amount": -1200,
          "is_approval": false
        }
      ],
      "transfers": [
        {
          "account": "0.0.3",
          "amount": 2,
          "is_approval": false
        },
        {
          "account": "0.0.8",
          "amount": -3,
          "is_approval": false
        },
        {
          "account": "0.0.98",
          "amount": 1,
          "is_approval": false
        },
        {
          "account": "0.0.800",
          "amount": 150,
          "is_approval": false
        },
        {
          "account": "0.0.800",
          "amount": 200,
          "is_approval": false
        }
      ],
      "valid_duration_seconds": 11,
      "valid_start_timestamp": "1234567890.000000006"
    }
  ]
}

Changes

Changed in 9 of the 53 revisions of this API.351936

  • v1985b30b8caa599See the full diff
    • ●

      added the new CRSPUBLICATION enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HINTSKEYPUBLICATION enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HINTSPARTIALSIGNATURE enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HINTSPREPROCESSINGVOTE enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HISTORYPROOFKEYPUBLICATION enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HISTORYPROOFSIGNATURE enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HISTORYPROOFVOTE enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new MIGRATIONROOTHASHVOTE enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new STATESIGNATURETRANSACTION enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ○

      added the new enum value CRSPUBLICATION to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      added the new enum value HINTSKEYPUBLICATION to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      added the new enum value HINTSPARTIALSIGNATURE to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      added the new enum value HINTSPREPROCESSINGVOTE to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      added the new enum value HISTORYPROOFKEYPUBLICATION to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      added the new enum value HISTORYPROOFSIGNATURE to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      added the new enum value HISTORYPROOFVOTE to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      added the new enum value MIGRATIONROOTHASHVOTE to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      added the new enum value STATESIGNATURETRANSACTION to the query request parameter transactiontype

      request-parameter-enum-value-added

  • v1f51904ce51a91See the full diff
    • ○

      added the optional property transactions/items/high_volume_pricing_multiplier to the response with the 200 status

      response-optional-property-added

  • v1f51042d19a8e33See the full diff
    • ●

      added the new REGISTEREDNODECREATE enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new REGISTEREDNODEDELETE enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new REGISTEREDNODEUPDATE enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ○

      added the new enum value REGISTEREDNODECREATE to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      added the new enum value REGISTEREDNODEDELETE to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      added the new enum value REGISTEREDNODEUPDATE to the query request parameter transactiontype

      request-parameter-enum-value-added

  • v121f905e40dd111See the full diff
    • ●

      added the new LEDGERIDPUBLICATION enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ○

      added the new enum value LEDGERIDPUBLICATION to the query request parameter transactiontype

      request-parameter-enum-value-added

  • v13eea44601e881See the full diff
    • ○

      added the optional property transactions/items/high_volume to the response with the 200 status

      response-optional-property-added

  • v1e44cfc649d5f112See the full diff
    • ▲

      removed the enum value LAMBDASSTORE from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ●

      added the new HOOKSTORE enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ○

      added the new enum value HOOKSTORE to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      removed the LAMBDASSTORE enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

  • v1f1ab65a800ac11See the full diff
    • ●

      added the new LAMBDASSTORE enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ○

      added the new enum value LAMBDASSTORE to the query request parameter transactiontype

      request-parameter-enum-value-added

  • v1b710de452fd322See the full diff
    • ▲

      removed the enum value NODE from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value UNKNOWN from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ○

      removed the NODE enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the UNKNOWN enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

  • v1db389f03b09732416See the full diff
    • ▲

      removed the enum value CRSPUBLICATION from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value HINTSKEYPUBLICATION from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value HINTSPARTIALSIGNATURE from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value HINTSPREPROCESSINGVOTE from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value HISTORYPROOFKEYPUBLICATION from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value HISTORYPROOFSIGNATURE from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value HISTORYPROOFVOTE from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value HOOKSTORE from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value LEDGERIDPUBLICATION from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value MIGRATIONROOTHASHVOTE from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value REGISTEREDNODECREATE from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value REGISTEREDNODEDELETE from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value REGISTEREDNODEUPDATE from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      removed the enum value STATESIGNATURETRANSACTION from the query request parameter transactiontype

      request-parameter-enum-value-removed

    • ▲

      the response property _status/messages/items/data became nullable for the status 400

      response-property-became-nullable

    • ▲

      the response property _status/messages/items/detail became nullable for the status 400

      response-property-became-nullable

    • ▲

      the response property links/next became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/batch_key became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/bytes became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/entity_id became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/max_custom_fees/items/account_id became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/max_custom_fees/items/denominating_token_id became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/memo_base64 became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/nft_transfers/items/receiver_account_id became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/nft_transfers/items/sender_account_id became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/nft_transfers/items/token_id became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/node became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/parent_consensus_timestamp became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/staking_reward_transfers/items/account became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/token_transfers/items/account became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/token_transfers/items/token_id became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property transactions/items/transfers/items/account became nullable for the status 200

      response-property-became-nullable

    • ●

      removed the optional property transactions/items/high_volume from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property transactions/items/high_volume_pricing_multiplier from the response with the 200 status

      response-optional-property-removed

    • ●

      added the new NODE enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new UNKNOWN enum value to the transactions/items/name response property for the response status 200

      response-property-enum-value-added

    • ○

      added the new enum value NODE to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      added the new enum value UNKNOWN to the query request parameter transactiontype

      request-parameter-enum-value-added

    • ○

      removed the CRSPUBLICATION enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the HINTSKEYPUBLICATION enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the HINTSPARTIALSIGNATURE enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the HINTSPREPROCESSINGVOTE enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the HISTORYPROOFKEYPUBLICATION enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the HISTORYPROOFSIGNATURE enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the HISTORYPROOFVOTE enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the HOOKSTORE enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the LEDGERIDPUBLICATION enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the MIGRATIONROOTHASHVOTE enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the REGISTEREDNODECREATE enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the REGISTEREDNODEDELETE enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the REGISTEREDNODEUPDATE enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the STATESIGNATURETRANSACTION enum value from the transactions/items/name response property for the response status 200

      response-property-enum-value-removed

    This revision also has 22 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog