# status - NEAR Protocol

This method returns **real-time information** about the NEAR node and the network it’s connected to. It provides details such as the **latest block**, **validator information**, **sync status**, and **node version** — making it essential for **monitoring node health** and **network connectivity**.

## Supported Networks

* Mainnet

## Parameters

* None

## Request Example

**Base URL**

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

**Example(cURL)**

```curl
curl -X POST https://go.getblock.io/<ACCESS_TOKEN> \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0",
"method": "status",
"params": [],
"id": "getblock.io"
}'
```

## Response Example

```json
{
    "jsonrpc": "2.0",
    "result": {
        "chain_id": "mainnet",
        "genesis_hash": "EPnLgE7iEq9s7yTkos96M3cWymH5avBAPm3qx3NXqR8H",
        "latest_protocol_version": 81,
        "node_key": null,
        "node_public_key": "ed25519:25NKtJin6cs4dDVqfrX15F8qHL8APKEPsZ8ZXkeQcZ1h",
        "protocol_version": 80,
        "rpc_addr": "0.0.0.0:3030",
        "sync_info": {
            "earliest_block_hash": "2YTH12o4WD5z8uMSNim1oM45oRZMMJVnHXYRbEGwXoL9",
            "earliest_block_height": 169582361,
            "earliest_block_time": "2025-10-24T00:26:02.397361265Z",
            "epoch_id": "78JmDEzNWqu1Z2RmLKoVqNvRn8tedtb1CwgyWsVg3ZK7",
            "epoch_start_height": 169789917,
            "latest_block_hash": "HPAkpQHzUJdNJm2UvguyGhwQHucyq47vACSfiUqNYTFu",
            "latest_block_height": 169796979,
            "latest_block_time": "2025-10-25T12:36:34.343644643Z",
            "latest_state_root": "43XupNhD4YyV9BkguKzBEqFzk8KKvhWMozaoWMiNPP8q",
            "syncing": false
        },
        "uptime_sec": 424867,
        "validator_account_id": null,
        "validator_public_key": null,
        "validators": [
            {
                "account_id": "bisontrails2.poolv1.near"
            },
            {
                "account_id": "astro-stakers.poolv1.near"
            },
            {
                "account_id": "zavodil.poolv1.near"
            },
            {
                "account_id": "binancenode1.poolv1.near"
            },
            {
                "account_id": "bitwise_1.poolv1.near"
            },
            {
                "account_id": "ledgerbyfigment.poolv1.near"
            },
        ],
        "version": {
            "build": "unknown",
            "commit": "unknown",
            "rustc_version": "1.86.0",
            "version": "2.9.0"
        }
    },
    "id": "getblock.io"
}
```

## Response Parameters Definition

| **Field**                              | **Type** | **Description**                                                               |
| -------------------------------------- | -------- | ----------------------------------------------------------------------------- |
| **chain\_id**                          | string   | The unique identifier of the blockchain network (e.g., `mainnet`, `testnet`). |
| **latest\_protocol\_version**          | integer  | The latest protocol version supported by the network.                         |
| **node\_key**                          | string   | The node’s cryptographic key used for synchronisation.                        |
| **protocol\_version**                  | integer  | The current protocol version running on the node.                             |
| **rpc\_addr**                          | string   | The RPC address through which the node communicates.                          |
| **sync\_info**                         | object   | Contains synchronisation details for block processing.                        |
| **sync\_info.earliest\_block\_hash**   | string   | Hash of the earliest block stored on the node.                                |
| **sync\_info.earliest\_block\_height** | integer  | Height (index) of the earliest stored block.                                  |
| **sync\_info.earliest\_block\_time**   | string   | Timestamp of the earliest block (ISO 8601 format).                            |
| **sync\_info.latest\_block\_hash**     | string   | Hash of the most recent block processed by the node.                          |
| **sync\_info.latest\_block\_height**   | integer  | Height of the most recent block.                                              |
| **sync\_info.latest\_block\_time**     | string   | Timestamp of the most recent block (ISO 8601 format).                         |
| **sync\_info.latest\_state\_root**     | string   | State root hash of the most recent block.                                     |
| **sync\_info.syncing**                 | boolean  | Indicates whether the node is still syncing with the network.                 |
| **uptime\_sec**                        | integer  | Node uptime in seconds.                                                       |
| **validator\_account\_id**             | string   | Account ID of the validator operating this node.                              |
| **validators**                         | array    | List of validators currently active in the network.                           |
| **validators.account\_id**             | string   | Identifier of the validator’s account.                                        |
| **validators.is\_slashed**             | boolean  | Shows if the validator has been slashed for misbehaviour.                     |
| **version**                            | object   | Contains node software version details.                                       |
| **version.version**                    | string   | Node software version number.                                                 |
| **version.build**                      | string   | Build label or release type (e.g., `release`, `debug`).                       |
| **version.rustc\_version**             | string   | Rust compiler version used to build the node.                                 |

## Use Cases

* Monitor **node health** and connection status.
* Retrieve **network-level information** for dashboards.
* Detect if a node is **out of sync** or lagging behind the network.
* Display **protocol and software version** information for maintenance and debugging.

## Code Example

**Node(Axios)**

```js
import axios from 'axios';
let data = JSON.stringify({
  "jsonrpc": "2.0",
  "method": "status",
  "params": [],
  "id": "getblock.io"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://go.getblock.io/<ACCESS_TOKEN>',
  headers: { 
    'Content-Type': 'application/json'
  },
  data : data
};

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

**Python(Requests)**

```python
import requests
import json

url = "https://go.getblock.io/<ACCESS_TOKEN>"

payload = json.dumps({
  "jsonrpc": "2.0",
  "method": "status",
  "params": [],
  "id": "getblock.io"
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
```

## Error Handling

| **HTTP Code**                 | **Error Message**       | **Description**                                        |
| ----------------------------- | ----------------------- | ------------------------------------------------------ |
| **500 Internal Server Error** | `Node processing error` | The node encountered an issue while retrieving status. |
| **403 Forbidden**             | `RBAC: access denied`   | The getblock access token is missing or incorrect      |

## Integration with Web3

By integrating `/status` into dApp, developers can:

* Build **network status dashboards** for validators and node operators.
* Enable **automatic node monitoring** and alerts.
* Check **protocol upgrades** or changes in real-time.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getblock.io/api-reference/near-protocol-near/near_status.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
