# /v1/blocks/by\_height/{block\_height} - Aptos

This endpoint gets a specific block's information from the Aptos blockchain network, given its height.

## Supported Networks

* Mainnet

## Parameter

| **Parameter**       | **Type** | **In** | **Required** | **Description**                                                      |
| ------------------- | -------- | ------ | ------------ | -------------------------------------------------------------------- |
| `block_height`      | Integer  | Path   | Yes          | Height (number) of the block to fetch.                               |
| `with_transactions` | Boolean  | Query  | No           | If true, returns full transactions inside the block. Default: false. |

## Request

**Base URL**

```bash
https://go.getblock.io/<ACCESS_TOKEN>
```

**Example(cURL)**

```curl
curl --location 'https://go.getblock.io/<ACCESS_TOKEN>/v1/blocks/by_height/425737645?with_transactions=false'
```

## Response Example

```json

{
    "block_height": "445814139",
    "block_hash": "0x0ac6b36f89b6a3fc9b7c2cabcb1f29cc624e609ed0978dd2a757b048196cb3bc",
    "block_timestamp": "1759349325550593",
    "first_version": "3492983944",
    "last_version": "3492983948",
    "transactions": null
}
```

## Response Parameter Definition

| **Field**                   | **Description**                                                           |
| --------------------------- | ------------------------------------------------------------------------- |
| block\_height               | The height of the block                                                   |
| block\_hash                 | The hash of the block at the specified height                             |
| block\_timestamp            | The time at which the block was created/added to the chain                |
| first\_version              | The version number of the first transaction in the block                  |
| last\_version               | The version number of the last transaction in the block                   |
| transactions                | An array containing the details of the transactions included in the block |
| type (transaction)          | The type of the change                                                    |
| hash                        | The hash of the transaction                                               |
| sender                      | The account from which the transaction was sent                           |
| sequence\_number            | The sequence of a transaction sent by the specific sender                 |
| max\_gas\_amount            | The maximum amount of gas allocated for the execution of a transaction    |
| gas\_unit\_price            | The cost per unit of gas (determines the transaction fee)                 |
| expiration\_timestamp\_secs | The timestamp until which the transaction can be included in a block      |
| payload                     | The data carried by a transaction                                         |
| type (payload)              | The type of payload indicates the purpose of the data contained           |
| function                    | The function associated with the payload                                  |
| type\_arguments             | An array specifying the types of arguments provided to the function       |
| arguments                   | An array containing the actual arguments passed to the function           |
| signature                   | An array with signature details                                           |
| type (signature)            | The type of signature used to verify authenticity                         |
| public\_key                 | The public key of the account that generated the signature                |
| signature (value)           | The actual signature generated with the private key                       |

## Use Cases

This method can be used for:

* Get a specific block by its height.
* Explore transactions inside a given block.
* Build block explorers or monitoring dashboards.

## Code Example

**Python(Request)**

```python
import requests

url = "https://go.getblock.io/<ACCESS_TOKEN>/v1/blocks/by_height/425737645?with_transactions=false"
response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
```

**Node(Axios)**

```js
import axios from ‘axios’

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: "https://go.getblock.io/<ACCESS_TOKEN>/v1/blocks/by_height/425737645?with_transactions=false"
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});
```

## Error Handling

| **Status Code** | **Error Message**     | **Cause**                                           |
| --------------- | --------------------- | --------------------------------------------------- |
| **403**         | Forbidden             | Invalid or missing ACCESS\_TOKEN.                   |
| **410**         | Block has been pruned | No block exists for the specified height or pruned. |
| **500**         | Internal server error | Node or network issue; retry later.                 |

## Integration with Web3

By integrating /v1/blocks/by\_height/{block\_height}, developers can:

* **Synchronise chain data** by fetching blocks sequentially.
* **Monitor on-chain activity** at the block level.
* **Enable dApps to verify inclusion** of transactions at a given height.