---
title: "Get the health for routing endpoints"
method: GET
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{iotHubName}/routingEndpointsHealth"
tags: ["GET"]
---

# Get the health for routing endpoints

`GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{iotHubName}/routingEndpointsHealth`

Get the health for routing endpoints.

## Path parameters

- `subscriptionId` string, required
- `resourceGroupName` string, required
- `iotHubName` string, required

## Query parameters

- `api-version` string, required

## Response `200`

OK

- EndpointHealthDataListResult — The JSON-serialized array of EndpointHealthData objects with a next link.
  - `value` EndpointHealthData[] — JSON-serialized array of Endpoint health data
    - `endpointId` string — Id of the endpoint
    - `healthStatus` 'unknown' | 'healthy' | 'unhealthy' | 'dead' — Health statuses have following meanings. The 'healthy' status shows that the endpoint is accepting messages as expected. The 'unhealthy' status shows that the endpoint is not accepting messages as expected and IoT Hub is retrying to send data to this endpoint. The status of an unhealthy endpoint will be updated to healthy when IoT Hub has established an eventually consistent state of health. The 'dead' status shows that the endpoint is not accepting messages, after IoT Hub retried sending messages for the retrial period. See IoT Hub metrics to identify errors and monitor issues with endpoints. The 'unknown' status shows that the IoT Hub has not established a connection with the endpoint. No messages have been delivered to or rejected from this endpoint
  - `nextLink` string — Link to more results

## Other responses

- `default` — DefaultErrorResponse

---

[API](https://skmtc.net/azure/apis/iothubclient.md) · [All operations](https://skmtc.net/azure/apis/iothubclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/iothubclient/versions/a0bee5faaac7/schema)