---
title: "Get a Block by Number or Hash"
method: GET
path: "/{protocol}/{network}/block/{block_identifier}"
tags: ["Blocks"]
---

# Get a Block by Number or Hash

`GET /{protocol}/{network}/block/{block_identifier}`

Get a block and all its transactions by a user-defined block number or block hash. 

Use `-1` or `current` parameter to return the current block.

## Path parameters

- `protocol` string, required
- `network` string, required
- `block_identifier` string, required

## Response `200`

Block

- Block — The block object.
  - `number` integer — The block number.
  - `id` string — The block hash.
  - `parent_id` string — The parent block hash.
  - `date` integer — The block date in unix timestamp format.
  - `num_txs` integer — The amount of transaction in the block.
  - `txs` Tx[] — A list of normalized transactions presented in the block (not filtered or unknown model).
    - `id` string — Unique transaction identifier.
    - `block_id` string, nullable — Block hash if mined, otherwise omitted.
    - `date` integer — The transaction creation unix timestamp.
    - `status` 'completed' | 'failed' — Result status of the transaction.
    - `num_events` integer — List of transaction events.
    - `meta` object — Protocol specific data that doesn't fit into a standard model.
    - `block_number` integer, nullable — Block number if mined, otherwise omitted.
    - `confirmations` integer — Total transaction confirmations.
    - `events` Event[], nullable
      - `id` string — The event identifier.
      - `transaction_id` string — The transaction identifer this event is presented.
      - `type` string — The event type.
      - `denomination` string, nullable — The Symbol of currency, can be natibe currency or token currency.
      - `destination` string, nullable — The destination address of the event.
      - `source` string, nullable — The source address of the event.
      - `meta` object — Protocol specific data that doesn't fit into a standard model.
        - `addresses` string[] — A list of addresses.
        - `index` integer — The index number.
        - `script` string — The script.
        - `script_type` string — The script type.
      - `date` integer — The event date in unix timestamp format.
      - `amount` integer, nullable — The coin amount transfered in the event.
      - `decimals` integer, nullable — The coin amount transfered in the event.
    - `assets` string[], nullable — List of moved assets by asset path. Find all the asset paths on this [page](https://docs.blockdaemon.com/reference/available-currencies-and-tokens).
    - `nonce` integer — The nonce of the transaction.

## Other responses

- `400` — Invalid Block Identifier
- `401` — Invalid or expired token
- `404` — Resource not found
- `429` — Rate limit exceeded
- `500` — An internal server error happened
- `503` — The resource you are trying to access is currently unavailable

---

[API](https://skmtc.dev/blockdaemon/apis/staking-api.md) · [All operations](https://skmtc.dev/blockdaemon/apis/staking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blockdaemon/staking-api/revisions/f94e296a08a3/schema)