GET /health

[!CAUTION] UNSTABLE: This endpoint is for operational monitoring and may change without notice.

Returns operational health information, primarily tracking history catchup progress.

Request


curl https://zo-devnet.n1.xyz/health

Response


{
  "watermarks": {
    "executedActionId": 123456,
    "historyActionId": 123400
  },
  "history": {
    "lastInsertAgeMs": 500
  },
  "status": {
    "historyStalled": false
  }
}

Response Fields

HealthInfo Object

Field	Type	Description
`watermarks`	Watermarks	Action ID watermarks for engine and history
`history`	History	History processing progress
`status`	Status	Overall health status flags

Watermarks Object

Field	Type	Description
`executedActionId`	number	Last action ID executed by the engine
`historyActionId`	number	Last action ID processed by the history service

History Object

Field	Type	Description
`lastInsertAgeMs`	number	Milliseconds since last history insert

Status Object

Field	Type	Description
`historyStalled`	boolean	True if history processing has stalled

Example: Python


import requests
 
API_URL = "https://zo-devnet.n1.xyz"
 
def check_health():
    resp = requests.get(f"{API_URL}/health")
    data = resp.json()
    
    lag = data["watermarks"]["executedActionId"] - data["watermarks"]["historyActionId"]
    stalled = data["status"]["historyStalled"]
    
    print(f"History lag: {lag} actions")
    print(f"Last insert: {data['history']['lastInsertAgeMs']}ms ago")
    print(f"Stalled: {stalled}")
    
    return not stalled
 
check_health()