Sign in

v1

latestOpenAPI 3.0.02026-07-17224996.6 KB
Transactions

Get Transaction Results by block

Retrieve a list of transaction results for a specific block. This includes results for submitted, system, and scheduled transactions.

get/transaction_results

Query parameters

block_idstring hexadecimal

A 32-byte unique identifier for an entity.

The ID of the block containing the transactions. The request may include either block_id or block_height, but not both.

string uint64
OR
'final' | 'sealed'

The height of the block containing the transactions. The request may include either block_id or block_height, but not both.

expandstring[]

A comma-separated list indicating which properties of the content to expand.

selectstring[]

A comma-separated list indicating which properties of the content to return.

agreeing_executors_countstring uint64

A minimum number of execution receipts for the execution result.

required_executor_idsIdentifier[]

A set of execution node IDs, one of which must have produced the execution result.

include_executor_metadataboolean

Specifies whether or not to include the executor metadata in the response.

Response

OK

block_idstring hexadecimal required

A 32-byte unique identifier for an entity.

collection_idstring hexadecimal required

A 32-byte unique identifier for an entity.

execution'Pending' | 'Success' | 'Failure'

This value indicates whether the transaction execution succeded or not, this value should be checked when determining transaction success.

status'Pending' | 'Finalized' | 'Executed' | 'Sealed' | 'Expired' required

This value indicates the state of the transaction execution. Only sealed and expired are final and immutable states.

status_codeinteger required
error_messagestring required

Provided transaction error in case the transaction wasn't successful.

computation_usedstring uint64 required

Example response

[
  {
    "collection_id": null,
    "error_message": "error_message",
    "execution": "Pending",
    "metadata": {
      "executor_metadata": {
        "execution_result_id": null,
        "executor_ids": [
          null,
          null
        ]
      }
    },
    "status_code": 0,
    "_links": {
      "_self": "_self"
    },
    "block_id": null,
    "computation_used": "computation_used",
    "events": [
      {
        "transaction_id": null,
        "payload": "",
        "transaction_index": "transaction_index",
        "type": "type",
        "event_index": "event_index"
      },
      {
        "transaction_id": null,
        "payload": "",
        "transaction_index": "transaction_index",
        "type": "type",
        "event_index": "event_index"
      }
    ],
    "status": "Pending"
  }
]