transactions

List transactions

Changed on

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

get/api/v1/transactions

Request

  • Base URL
    (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/v1/transactions
  • Auth
    none declared

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' | 'CLPRCLOSECHANNEL' | 'CLPRCOMPLETECHANNEL' | 'CLPRCOMPLETECONNECTOR' | 'CLPRDEREGISTERCONNECTOR' | 'CLPRREDACTMESSAGE' | 'CLPRREGISTERCHANNEL' | 'CLPRREGISTERCONNECTOR' | 'CLPRSUBMITBUNDLE' | 'CLPRUPDATELEDGERCONFIGURATION' | '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

  • v1fc88183ee7a8Revision changes
    • warning

      added the new CLPRCLOSECHANNEL enum value to the // response property for the response status

    • warning

      added the new CLPRCOMPLETECHANNEL enum value to the // response property for the response status

    • warning

      added the new CLPRCOMPLETECONNECTOR enum value to the // response property for the response status

    • warning

      added the new CLPRDEREGISTERCONNECTOR enum value to the // response property for the response status

    • warning

      added the new CLPRREDACTMESSAGE enum value to the // response property for the response status

    • warning

      added the new CLPRREGISTERCHANNEL enum value to the // response property for the response status

    • warning

      added the new CLPRREGISTERCONNECTOR enum value to the // response property for the response status

    • warning

      added the new CLPRSUBMITBUNDLE enum value to the // response property for the response status

    • warning

      added the new CLPRUPDATELEDGERCONFIGURATION enum value to the // response property for the response status

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

  • v1985b30b8caa5Revision changes
    • warning

      added the new CRSPUBLICATION enum value to the // response property for the response status

    • warning

      added the new HINTSKEYPUBLICATION enum value to the // response property for the response status

    • warning

      added the new HINTSPARTIALSIGNATURE enum value to the // response property for the response status

    • warning

      added the new HINTSPREPROCESSINGVOTE enum value to the // response property for the response status

    • warning

      added the new HISTORYPROOFKEYPUBLICATION enum value to the // response property for the response status

    • warning

      added the new HISTORYPROOFSIGNATURE enum value to the // response property for the response status

    • warning

      added the new HISTORYPROOFVOTE enum value to the // response property for the response status

    • warning

      added the new MIGRATIONROOTHASHVOTE enum value to the // response property for the response status

    • warning

      added the new STATESIGNATURETRANSACTION enum value to the // response property for the response status

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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