API Reference
Dashboard
  1. API Reference
  2. ProxyMarket API
  3. Proxy health

Report the health of your proxies

Send the state of each proxy about every 5 minutes. This is a different thing from HEAD {webhook_url}/health, the liveness check ProxyMarket runs on your server: that one keeps your plans listed, this one reports single proxies. Limit: 30 calls a minute.

  • Action · reversible
  • Vendor API key (X-API-Key)
  • reportHealth
POST/integration/health

Request body application/json · required

[].external_idstringrequired

The plan (port) this report is about.

[].statusstringrequired
One of online, offline, rotating
[].current_ipstringoptional

Current public IP of the proxy.

[].latency_msintegeroptional

Response time in milliseconds.

[].uptime_secondsintegeroptional

Seconds since the modem last restarted.

Responses

How many reports were taken.

receivedintegeroptional
Verified against ProxyMarket vendor guide v1.11 on Nov 20, 2026