v1

latestOpenAPI 3.0.02026-07-17224996.6 KB
Blocks

Get Blocks by ID.

Get a block data or list of blocks by the provided ID or list of IDs.

get/blocks/{id}

Path parameters

idIdentifier[] required

A block ID or comma-separated list of block IDs.

Query parameters

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.

Response

OK

block_status'BLOCK_UNKNOWN' | 'BLOCK_FINALIZED' | 'BLOCK_SEALED' required

This value indicates the status of a block.

Example response

[
  {
    "block_status": "BLOCK_UNKNOWN",
    "payload": {
      "collection_guarantees": [
        {
          "collection_id": null,
          "signer_ids": [
            null,
            null
          ],
          "signature": null,
          "reference_block_id": null,
          "cluster_chain_id": "cluster_chain_id"
        },
        {
          "collection_id": null,
          "signer_ids": [
            null,
            null
          ],
          "signature": null,
          "reference_block_id": null,
          "cluster_chain_id": "cluster_chain_id"
        }
      ],
      "block_seals": [
        {
          "result_id": null,
          "final_state": "final_state",
          "aggregated_approval_signatures": [
            {
              "verifier_signatures": [
                null,
                null
              ],
              "signer_ids": [
                null,
                null
              ]
            },
            {
              "verifier_signatures": [
                null,
                null
              ],
              "signer_ids": [
                null,
                null
              ]
            }
          ],
          "block_id": null
        },
        {
          "result_id": null,
          "final_state": "final_state",
          "aggregated_approval_signatures": [
            {
              "verifier_signatures": [
                null,
                null
              ],
              "signer_ids": [
                null,
                null
              ]
            },
            {
              "verifier_signatures": [
                null,
                null
              ],
              "signer_ids": [
                null,
                null
              ]
            }
          ],
          "block_id": null
        }
      ]
    },
    "_links": null,
    "header": {
      "parent_id": null,
      "id": "id",
      "parent_voter_signature": "",
      "height": "height",
      "timestamp": "2000-01-23T04:56:07.000+00:00"
    },
    "execution_result": {
      "metadata": {
        "executor_metadata": {
          "execution_result_id": null,
          "executor_ids": [
            null,
            null
          ]
        }
      },
      "_links": {
        "_self": "_self"
      },
      "chunks": [
        {
          "start_state": "",
          "index": "index",
          "number_of_transactions": "number_of_transactions",
          "collection_index": "collection_index",
          "end_state": "",
          "event_collection": "",
          "block_id": null,
          "total_computation_used": "total_computation_used"
        },
        {
          "start_state": "",
          "index": "index",
          "number_of_transactions": "number_of_transactions",
          "collection_index": "collection_index",
          "end_state": "",
          "event_collection": "",
          "block_id": null,
          "total_computation_used": "total_computation_used"
        }
      ],
      "id": null,
      "previous_result_id": null,
      "block_id": null,
      "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"
        }
      ]
    },
    "_expandable": {
      "payload": "payload",
      "execution_result": "http://example.com/aeiou"
    }
  }
]