---
title: "Query the health of the node."
method: GET
path: "/v3/health"
tags: ["Info"]
---

# Query the health of the node.

`GET /v3/health`

Get node health information.
A node is considered healthy if its Stacks tip height matches the maximum Stacks tip height observed among its connected peers.
This endpoint returns:
- `difference_from_max_peer`: The difference in Stacks height between this node and its most advanced peer.
- `max_stacks_height_of_neighbors`: The maximum Stacks height observed among the node"s connected peers.
- `node_stacks_tip_height`: The current Stacks tip height of this node.
- `max_stacks_neighbor_address`: The address of the most advanced peer. Null if no peer data is available.

## Response `200`

Success

- GetHealth — unresolved $ref

## Other responses

- `400` — Bad request
- `500` — Internal Server Error

## Changes

- **2025-08-05** `a9c44dcce761` — 1 warning
  - deleted the `query` request parameter `neighbors`
- **2025-07-09** `04a9a0b50aa3` — 2 breaking, 3 info
  - removed the media type `application/json` for the response with the status `400`
  - removed the media type `application/json` for the response with the status `500`
  - api operation id `get_health` removed and replaced with `getNodeHealth`
  - added the media type `text/plain` for the response with the status `400`
  - …1 more
- **2025-07-08** `488dd3b80020` — 2 breaking, 3 info
  - removed the media type `text/plain` for the response with the status `400`
  - removed the media type `text/plain` for the response with the status `500`
  - api operation id `getNodeHealth` removed and replaced with `get_health`
  - added the media type `application/json` for the response with the status `400`
  - …1 more
- **2025-07-08** `170414634c90` — 1 breaking, 4 info
  - removed the media type `application/json` for the response with the status `500`
  - api operation id `get_health` removed and replaced with `getNodeHealth`
  - added the new optional `query` request parameter `neighbors`
  - added the media type `text/plain` for the response with the status `500`
  - …1 more
- **2025-06-27** `7e7074ff0803` — 1 warning, 1 info
  - deleted the `query` request parameter `neighbors`
  - removed the non-success response with the status `400`

[Full history](https://skmtc.dev/stacks-network/apis/stacks-3-0-rpc-api/changes/v3/health/get.md)

---

[API](https://skmtc.dev/stacks-network/apis/stacks-3-0-rpc-api.md) · [All operations](https://skmtc.dev/stacks-network/apis/stacks-3-0-rpc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stacks-network/stacks-3-0-rpc-api/revisions/bfe6e0b30f62/schema)