Documentation

TopNetworks API

One endpoint. Live health status for every major AI provider. No API key. No signup. Free.

Endpoint

Public · No auth required
GET https://topnetworks.com/api/v1/health

Auth

None

Rate limit

Fair use

Cache

No-store

Format

JSON

Response Format

200 OK · application/json
{
  "timestamp": "2026-03-12T05:00:00Z",
  "providers": {
    "openai":    { "status": "operational", "last_checked": "2026-03-12T04:59:58Z", "response_time_ms": 112 },
    "anthropic": { "status": "operational", "last_checked": "2026-03-12T04:59:58Z", "response_time_ms": 98  },
    "groq":      { "status": "degraded",    "last_checked": "2026-03-12T04:59:58Z", "response_time_ms": 843 },
    "runway":    { "status": "outage",      "last_checked": "2026-03-12T04:59:58Z", "response_time_ms": null }
  },
  "summary": {
    "operational": 16,
    "degraded": 1,
    "outage": 1,
    "unknown": 0
  }
}

Fields

Field	Type	Description
timestamp	string	ISO 8601 timestamp the response was generated.
providers	object	Map of provider_id → health object.
.status	string	"operational" \| "degraded" \| "outage" \| "unknown"
.last_checked	string \| null	ISO timestamp of last poll.
.response_time_ms	number \| null	Time (ms) to fetch the provider's status page from our polling server. Not end-user API latency.
summary.operational	number	Count of operational providers.
summary.degraded	number	Count of degraded providers.
summary.outage	number	Count of providers with active outage.
summary.unknown	number	Count of providers with unknown status.

Provider IDs

Use these stable IDs to reference specific providers in the response.

openai→anthropic→google-gemini→cohere→deepseek→groq→cerebras→stability-ai→replicate→ideogram→elevenlabs→deepgram→assemblyai→pinecone→github-copilot→tabnine→tavily→runway→

Code Examples

GET /api/v1/health

curl -s https://topnetworks.com/api/v1/health | jq '.summary'

Status Codes

200

Request succeeded. Parse the providers object.

500

Server Error

Something went wrong. Retry with exponential backoff.

x402 Premium AccessLive

The premium endpoint uses the x402 protocol — HTTP 402 Payment Required. Agents pay $0.001 USDC per call on Base L2. No API keys. No accounts. Settlement in ~2 seconds.

Endpoint	Cost	Returns
GET /api/v1/health	Free	status, last_checked, response_time_ms
GET /api/v1/health/premium	$0.001 USDC / call	+ uptime_pct, avg_response_ms, p95_response_ms, recent_incidents, rate_limit_risk

GET /api/v1/health/premium · $0.001 USDC

# curl — see the 402 response and payment instructions
curl -i https://topnetworks.com/api/v1/health/premium

# HTTP/1.1 402 Payment Required
# Content-Type: application/json
#
# {
#   "x402Version": 1,
#   "error": "X-PAYMENT header is required",
#   "accepts": [{
#     "scheme": "exact",
#     "network": "base",
#     "maxAmountRequired": "1000",
#     "payTo": "0x8De706a42d949D8D021838398051d70127b72f34",
#     "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
#   }]
# }