Skip to main content
The Health endpoint provides a simple, unauthenticated liveness check for WireSocket Data Plane nodes. It is used by load balancers (e.g., Bunny DNS) and monitoring systems to determine whether a node should receive traffic.

Endpoints

Both paths return the same response:
GET https://{region-code}.wiresocket.net/health
GET https://{region-code}.wiresocket.net/

Authentication

None required. This endpoint is publicly accessible to support load balancer health probes.

Response

The endpoint returns one of two HTTP status codes based on the node’s internal state:
HTTP StatusStateDescription
200HEALTHYThe node is operating normally and can accept new connections.
503DEGRADED / OVERLOADEDThe node is under pressure or Redis is unreachable. Load balancers should route traffic away.

Response Body

{
  "status": "healthy",
  "timestamp": "2026-03-04T06:00:00.000Z"
}
FieldTypeDescription
statusstringCurrent node state: healthy, degraded, or overloaded.
timestampstringISO 8601 UTC timestamp of the check.

Rate Limiting

This endpoint uses the HEALTH rate limit policy, which is more permissive than standard endpoints to allow frequent polling by infrastructure services.
Last modified on March 4, 2026