Check-Host.cc

API Documentation

Distributed network diagnostics from 65+ global nodes — Ping, MTR, DNS, HTTP, TCP and UDP — plus host metadata, WHOIS, and historic check reports. Every endpoint below is editable and executable in your browser against the live API.

SDK
Node.js
SDK
Python
SDK
PHP 8.1+
SDK
Go
SDK
Java
What's this for?

Anonymous works for most things. Conservative per-IP and per-target rate limits apply — see the full table on /about if you need the exact numbers.

An API key (UUID format) lifts those limits with a per-key monthly quota. Keys are free — Check-Host is a non-profit project and the limits exist only to prevent abuse, not to monetise. If you have a legitimate use case that exceeds the anonymous tier, reach out via support.

Send the key as an Authorization: Bearer <key> header — the code samples below fill this in for you. For backward compatibility an apikey field in a POST body is still accepted; passing it in the URL query string is not.

Privacy: the key lives only in your browser's localStorage on this page and is sent only to api.check-host.cc.

Quick start

Submitting a check is asynchronous: (1) POST to a monitoring endpoint to get a UUID, (2) poll /report/{uuid} until every node has reported. Most checks complete in 1–10 seconds. Endpoints below auto-poll for you when you click Execute.

Polling pattern (bash) 
# 1. Dispatch a check, capture the UUID
UUID=$(curl -s -X POST https://api.check-host.cc/ping \
  -H 'Content-Type: application/json' \
  -d '{"target":"check-host.cc","region":["DE"]}' | jq -r .uuid)

# 2. Poll until at least one node has reported
until curl -s "https://api.check-host.cc/report/$UUID" \
  | jq -e '.data | length >= 1' > /dev/null; do sleep 1; done

curl -s "https://api.check-host.cc/report/$UUID" | jq .

Lookups

8 endpoints

IP, geolocation, WHOIS and the live node list.

Global Checks

12 endpoints

Dispatch a Ping / TCP / UDP / HTTP / DNS / MTR check from 65+ global nodes — each call returns a UUID, then auto-polls /report/{uuid} for results.

Quick GET shortcuts

Drop-in URLs for simple checks — no region targeting or Live Mode (use POST above for those).

Network Intelligence

3 endpoints

Dispatch deep, multi-stage scans (port + banner + body + TLS + threat-intel) of an IP, CIDR, domain or ASN. Asynchronous: submit, then poll the status endpoint. Open to guests, with per-IP and per-target hourly quotas.

Intelligence Data

8 endpoints

Read the aggregated intelligence we already hold for an entity — the same data that powers the /ip, /as, /domain … pages, as JSON. Open to guests with a per-IP rate limit; an API key lifts the limits.

Geo Intelligence

4 endpoints

Country, TLD and continent-level aggregates plus the global threat feed — the same data that powers the /country, /tld, /continent and /threats pages, as JSON. Open to guests with a per-IP rate limit; an API key lifts the limits.

Reporting

3 endpoints

Fetch the JSON report or rendered status images for a previously dispatched check.