{"openapi":"3.1.0","info":{"title":"Host Check API","version":"1.0.0","description":"Check whether a host or website is reachable from dozens of locations around the world as an API, powered by check-host.net. Run an ICMP ping, an HTTP request, a TCP-port connect or a DNS resolution from many countries at once and get a per-node breakdown — reachable or not, response time, resolved IP, HTTP status code or DNS records — plus an aggregate \"reachable from X of N nodes\". Perfect for answering \"is it down for everyone, or just me?\", monitoring global uptime and latency, verifying CDN and geo-routing, debugging firewalls and regional blocks, and powering status pages. Also lists every available worldwide check node. No accounts, no agents to install.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/hostcheck-api","description":"oanor gateway"}],"tags":[{"name":"Checks"},{"name":"Reference"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/dns":{"get":{"operationId":"get_v1_dns","tags":["Checks"],"summary":"DNS resolution check","description":"","parameters":[{"name":"host","in":"query","required":true,"description":"Domain, e.g. example.com","schema":{"type":"string"},"example":"example.com"},{"name":"max_nodes","in":"query","required":false,"description":"Nodes 1-20","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"dns","target":"example.com","results":[{"A":["104.20.23.154","172.66.147.243"],"ttl":300,"AAAA":["2606:4700:10::ac42:93f3","2606:4700:10::6814:179a"],"city":"Sofia","node":"bg1.node.check-host.net","country":"Bulgaria","reachable":true},{"A":["104.20.23.154","172.66.147.243"],"ttl":300,"AAAA":["2606:4700:10::6814:179a","2606:4700:10::ac42:93f3"],"city":"Frankfurt","node":"de4.node.check-host.net","country":"Germany","reachable":true},{"A":["8.6.112.0","8.47.69.0"],"ttl":51,"AAAA":["2a06:98c1:3123:8000::","2a06:98c1:3122:8000::"],"city":"Helsinki","node":"fi1.node.check-host.net","country":"Finland","reachable":true},{"A":["104.20.23.154","172.66.147.243"],"ttl":37,"AAAA":["2606:4700:10::6814:179a","2606:4700:10::ac42:93f3"],"city":"Vilnius","node":"lt1.node.check-host.net","country":"Lithuania","reachable":true},{"A":["104.20.23.154","172.66.147.243"],"ttl":150,"AAAA":["2606:4700:10::6814:179a","2606:4700:10::ac42:93f3"],"city":"New York","node":"us5.node.check-host.net","country":"USA","reachable":true}],"nodes_checked":5,"permanent_link":"https://check-host.net/check-report/40d77229k36e","reachable_from":5},"meta":{"timestamp":"2026-06-01T00:04:13.094Z","request_id":"3aae7b37-084b-41bc-a5bd-dda3e5803940"},"status":"ok","message":"DNS checked","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/http":{"get":{"operationId":"get_v1_http","tags":["Checks"],"summary":"HTTP check from worldwide nodes","description":"","parameters":[{"name":"url","in":"query","required":true,"description":"URL, e.g. https://example.com","schema":{"type":"string"},"example":"https://example.com"},{"name":"max_nodes","in":"query","required":false,"description":"Nodes 1-20","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"http","target":"https://example.com","results":[{"ip":"172.66.147.243","city":"Vancouver","node":"ca1.node.check-host.net","country":"Canada","message":"OK","time_ms":21,"reachable":true,"status_code":"200"},{"ip":"8.47.69.0","city":"Zurich","node":"ch1.node.check-host.net","country":"Switzerland","message":"OK","time_ms":72,"reachable":true,"status_code":"200"},{"ip":"104.20.23.154","city":"Zhejiang","node":"cn1.node.check-host.net","country":"China","message":"OK","time_ms":688,"reachable":true,"status_code":"200"},{"ip":"104.20.23.154","city":"Milan","node":"it2.node.check-host.net","country":"Italy","message":"OK","time_ms":15,"reachable":true,"status_code":"200"},{"ip":"104.20.23.154","city":"Vilnius","node":"lt1.node.check-host.net","country":"Lithuania","message":"OK","time_ms":11,"reachable":true,"status_code":"200"}],"nodes_checked":5,"permanent_link":"https://check-host.net/check-report/40d77232kba8","reachable_from":5},"meta":{"timestamp":"2026-06-01T00:04:15.199Z","request_id":"5c928d9a-d21f-4ae0-aead-d7df62bee61d"},"status":"ok","message":"HTTP checked","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/ping":{"get":{"operationId":"get_v1_ping","tags":["Checks"],"summary":"ICMP ping from worldwide nodes","description":"","parameters":[{"name":"host","in":"query","required":true,"description":"Host, e.g. google.com","schema":{"type":"string"},"example":"google.com"},{"name":"max_nodes","in":"query","required":false,"description":"Nodes 1-20 (default 5)","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"ping","target":"google.com","results":[{"ip":"142.251.142.14","city":"Paris","node":"fr2.node.check-host.net","status":"OK","country":"France","packets":4,"received":4,"reachable":true,"avg_time_ms":2},{"city":"Tehran","node":"ir1.node.check-host.net","status":"pending","country":"Iran"},{"ip":"142.251.38.110","city":"Karaganda","node":"kz1.node.check-host.net","status":"OK","country":"Kazakhstan","packets":4,"received":4,"reachable":true,"avg_time_ms":109},{"ip":"192.178.25.14","city":"Stockholm","node":"se1.node.check-host.net","status":"OK","country":"Sweden","packets":4,"received":4,"reachable":true,"avg_time_ms":1},{"ip":"74.125.200.139","city":"Singapore","node":"sg1.node.check-host.net","status":"OK","country":"Singapore","packets":4,"received":4,"reachable":true,"avg_time_ms":3}],"nodes_checked":5,"permanent_link":"https://check-host.net/check-report/40d7723bk6ee","reachable_from":4},"meta":{"timestamp":"2026-06-01T00:04:18.240Z","request_id":"23ab8609-9095-4418-8694-1d6ab272bf2d"},"status":"ok","message":"Ping checked","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/tcp":{"get":{"operationId":"get_v1_tcp","tags":["Checks"],"summary":"TCP-connect check","description":"","parameters":[{"name":"host","in":"query","required":true,"description":"host:port, e.g. example.com:443","schema":{"type":"string"},"example":"example.com:443"},{"name":"max_nodes","in":"query","required":false,"description":"Nodes 1-20","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"tcp","target":"example.com:443","results":[{"ip":"172.66.147.243","city":"Madrid","node":"es1.node.check-host.net","country":"Spain","time_ms":5,"reachable":true},{"ip":"172.66.147.243","city":"Barcelona","node":"es2.node.check-host.net","country":"Spain","time_ms":15,"reachable":true},{"ip":"104.20.23.154","city":"Hong Kong","node":"hk1.node.check-host.net","country":"Hong Kong","time_ms":1030,"reachable":true},{"ip":"104.20.23.154","city":"Kolkata","node":"in5.node.check-host.net","country":"India","time_ms":72,"reachable":true},{"ip":"8.6.112.0","city":"Moscow","node":"ru1.node.check-host.net","country":"Russia","time_ms":31,"reachable":true}],"nodes_checked":5,"permanent_link":"https://check-host.net/check-report/40d77251k455","reachable_from":5},"meta":{"timestamp":"2026-06-01T00:04:21.267Z","request_id":"12e43101-016f-4d5f-98a6-dd136c039874"},"status":"ok","message":"TCP checked","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/nodes":{"get":{"operationId":"get_v1_nodes","tags":["Reference"],"summary":"Available check nodes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":61,"nodes":[{"ip":"176.125.231.26","asn":"AS9009","city":"Dubai","node":"ae1.node.check-host.net","country":"UAE"},{"ip":"185.224.3.111","asn":"AS64457","city":"Vienna","node":"at1.node.check-host.net","country":"Austria"},{"ip":"93.123.16.89","asn":"AS9028","city":"Sofia","node":"bg1.node.check-host.net","country":"Bulgaria"},{"ip":"45.162.230.209","asn":"AS268581","city":"Sao Paulo","node":"br1.node.check-host.net","country":"Brazil"},{"ip":"198.135.169.20","asn":"AS396993","city":"Vancouver","node":"ca1.node.check-host.net","country":"Canada"},{"ip":"179.43.148.195","asn":"AS51852","city":"Zurich","node":"ch1.node.check-host.net","country":"Switzerland"},{"ip":"81.6.41.187","asn":"AS13030","city":"Zurich","node":"ch2.node.check-host.net","country":"Switzerland"},{"ip":"110.42.102.106","asn":"AS136188","city":"Zhejiang","node":"cn1.node.check-host.net","country":"China"},{"ip":"77.75.230.51","asn":"AS209847","city":"C.Budejovice","node":"cz1.node.check-host.net","country":"Czechia"},{"ip":"116.203.22.31","asn":"AS24940","city":"Nuremberg","node":"de1.node.check-host.net","country":"Germany"},{"ip":"185.37.147.117","asn":"AS34549","city":"Frankfurt","node":"de4.node.check-host.net","country":"Germany"},{"ip":"78.40.111.151","asn":"AS215691","city":"Madrid","node":"es1.node.check-host.net","country":"Spain"},{"ip":"194.26.100.165","asn":"AS26141","city":"Barcelona","node":"es2.node.check-host.net","country":"Spain"},{"ip":"65.109.182.130","asn":"AS24940","city":"Helsinki","node":"fi1.node.check-host.net","country":"Finland"},{"ip":"195.154.114.92","asn":"AS12876","city":"Paris","node":"fr2.node.check-host.net","country":"France"},{"ip":"141.98.234.68","asn":"AS207713","city":"Hong Kong","node":"hk1.node.check-host.net","country":"Hong Kong"},{"ip":"45.9.168.235","asn":"AS211619","city":"Nyiregyhaza","node":"hu1.node.check-host.net","country":"Hungary"},{"ip":"103.42.116.205","asn":"AS141968","city":"Jakarta","node":"id2.node.check-host.net","country":"Indonesia"},{"ip":"94.154.123.196","asn":"AS206446","city":"Tel Aviv","node":"il1.node.check-host.net","country":"Israel"},{"ip":"195.211.24.52","asn":"AS206446","city":"Netanya","node":"il2.node.check-host.net","country":"Israel"},{"ip":"185.2.49.144","asn":"AS16276","city":"Mumbai","node":"in1.node.check-host.net","country":"India"},{"ip":"181.214.10.239","asn":"AS140641","city":"Delhi","node":"in2.node.check-host.net","country":"India"},{"ip":"151.243.98.61","asn":"AS149573","city":"Hyderabad","node":"in3.node.check-host.net","country":"India"},{"ip":"103.183.157.60","asn":"AS149573","city":"Bengaluru","node":"in4.node.check-host.net","country":"India"},{"ip":"151.243.12.65","asn":"AS149573","city":"Kolkata","node":"in5.node.check-host.net","country":"India"},{"ip":"185.105.238.209","asn":"AS47430","city":"Tehran","node":"ir1.node.check-host.net","country":"Iran"},{"ip":"185.79.159.20","asn":"AS58224","city":"Isfahan","node":"ir5.node.check-host.net","country":"Iran"},{"ip":"109.122.245.39","asn":"AS208264","city":"Karaj","node":"ir6.node.check-host.net","country":"Iran"},{"ip":"5.190.20.10","asn":"AS58224","city":"Khonj","node":"ir9.node.check-host.net","country":"Iran"},{"ip":"185.25.204.60","asn":"AS60798","city":"Milan","node":"it2.node.check-host.net","country":"Italy"},{"ip":"103.214.169.52","asn":"AS149042","city":"Tokyo","node":"jp1.node.check-host.net","country":"Japan"},{"ip":"185.120.77.165","asn":"AS203087","city":"Karaganda","node":"kz1.node.check-host.net","country":"Kazakhstan"},{"ip":"88.119.179.10","asn":"AS198651","city":"Vilnius","node":"lt1.node.check-host.net","country":"Lithuania"},{"ip":"178.17.171.235","asn":"AS43289","city":"Chisinau","node":"md1.node.check-host.net","country":"Moldova"},{"ip":"185.209.161.145","asn":"AS14576","city":"Amsterdam","node":"nl1.node.check-host.net","country":"Netherlands"},{"ip":"195.211.27.85","asn":"AS206446","city":"Meppel","node":"nl2.node.check-host.net","country":"Netherlands"},{"ip":"178.216.200.169","asn":"AS31229","city":"Poznan","node":"pl1.node.check-host.net","country":"Poland"},{"ip":"195.137.244.1","asn":"AS214379","city":"Warsaw","node":"pl2.node.check-host.net","country":"Poland"},{"ip":"185.83.213.25","asn":"AS44222","city":"Viana","node":"pt1.node.check-host.net","country":"Portugal"},{"ip":"107.149.201.15","asn":"AS211281","city":"Bucharest","node":"ro1.node.check-host.net","country":"Romania"},{"ip":"194.146.57.64","asn":"AS35779","city":"Belgrade","node":"rs1.node.check-host.net","country":"Serbia"},{"ip":"185.130.104.238","asn":"AS14576","city":"Moscow","node":"ru1.node.check-host.net","country":"Russia"},{"ip":"194.26.229.20","asn":"AS210644","city":"Moscow","node":"ru2.node.check-host.net","country":"Russia"},{"ip":"185.221.199.82","asn":"AS210644","city":"Saint Petersburg","node":"ru3.node.check-host.net","country":"Russia"},{"ip":"147.45.113.30","asn":"AS41925","city":"Ekaterinburg","node":"ru4.node.check-host.net","country":"Russia"},{"ip":"78.40.116.61","asn":"AS200019","city":"Stockholm","node":"se1.node.check-host.net","country":"Sweden"},{"ip":"195.137.245.1","asn":"AS214379","city":"Stockholm","node":"se2.node.check-host.net","country":"Sweden"},{"ip":"217.15.166.168","asn":"AS141995","city":"Singapore","node":"sg1.node.check-host.net","country":"Singapore"},{"ip":"83.143.119.103","asn":"AS49592","city":"Maribor","node":"si1.node.check-host.net","country":"Slovenia"},{"ip":"185.23.17.21","asn":"AS211557","city":"Istanbul","node":"tr1.node.check-host.net","country":"Turkey"},{"ip":"77.92.151.181","asn":"AS44620","city":"Istanbul","node":"tr2.node.check-host.net","country":"Turkey"},{"ip":"185.86.77.126","asn":"AS201094","city":"Khmelnytskyi","node":"ua1.node.check-host.net","country":"Ukraine"},{"ip":"91.231.182.39","asn":"AS214379","city":"Kyiv","node":"ua2.node.check-host.net","country":"Ukraine"},{"ip":"104.28.192.94","asn":"AS13335","city":"Kyiv","node":"ua3.node.check-host.net","country":"Ukraine"},{"ip":"45.159.248.77","asn":"AS209847","city":"Coventry","node":"uk1.node.check-host.net","country":"UK"},{"ip":"38.145.202.12","asn":"AS18978","city":"Los Angeles","node":"us1.node.check-host.net","country":"USA"},{"ip":"64.72.205.76","asn":"AS215703","city":"Dallas","node":"us2.node.check-host.net","country":"USA"},{"ip":"147.45.60.14","asn":"AS215540","city":"Atlanta","node":"us3.node.check-host.net","country":"USA"},{"ip":"157.254.174.204","asn":"AS26141","city":"Miami","node":"us4.node.check-host.net","country":"USA"},{"ip":"162.217.248.181","asn":"AS213535","city":"New York","node":"us5.node.check-host.net","country":"USA"},{"ip":"45.252.248.142","asn":"AS63760","city":"Ho Chi Minh City","node":"vn1.node.check-host.net","country":"Vietnam"}]},"meta":{"timestamp":"2026-06-01T00:04:21.410Z","request_id":"78a68f83-eb24-4df7-b6ac-766768dd0925"},"status":"ok","message":"Nodes retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Check a host from dozens of worldwide nodes. /v1/ping?host=google.com — ICMP ping (reachable, avg time, ip per node); /v1/http?url=https://example.com — HTTP check (status code, time); /v1/tcp?host=example.com:443 — TCP-connect check; /v1/dns?host=example.com — DNS resolution; /v1/nodes — the available locations. Each call runs across max_nodes (1-20, default 5) countries and waits a few seconds for results — perfect for 'is it down for everyone' and global uptime checks.","checks":["ping","http","tcp","dns"],"source":"check-host.net","endpoints":["/v1/ping","/v1/http","/v1/tcp","/v1/dns","/v1/nodes","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:21.478Z","request_id":"2ed3e1b6-daa3-4ed1-8702-d6e7dec5675c"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":690,"monthly_call_quota":42000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1990,"monthly_call_quota":210000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4990,"monthly_call_quota":1050000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/hostcheck-api"}