NewAPIVerve Academy: free courses and certifications anyone can verify.Explore the Academy →

Domain and IP Pinger API

POST

Verify whether any domain or public IP is currently online.

Domain and IP Pinger checks whether any domain name or public IP address is reachable and responding in real time. It returns an alive status and successful round trips, while paid plans add packet loss percentages and latency metrics.

Try it — live request, no key required

Request
POSTapi.apiverve.com/v1/pinger
Body
Verification
Format

No key required to try it. Get a key to use it in your app.

Example
{
  "status": "ok",
  "error": null,
  "data": {
    "host": "google.com",
    "numericHost": "2607:f8b0:4001:c6e::8a",
    "alive": true,
    "roundTrips": 3,
    "packetLoss": 0,
    "minMS": 0.652,
    "avgMS": 0.6846666666666666,
    "maxMS": 0.712,
    "stdDev": 0.02478350706058811,
    "times": [
      0.712,
      0.652,
      0.69
    ]
  }
}

About the Domain and IP Pinger API

A ping API to ping a domain online or ping an IP address without opening a terminal. Send a POST request with a hostname or public IP address and the desired ping count, and the service sends ICMP echo requests to the target in real time from our servers, reporting whether it answered and how many round trips completed.

The Free plan returns the host, an alive flag and the number of successful round trips. That covers a quick check of host reachability on a status page, in a support tool, or in a bot that answers whether a site is down for everyone or only for one user.

Paid plans add the numbers needed to test server latency: the resolved numeric IP, a packet loss check as a percentage, minimum, average and maximum round-trip times in milliseconds, their standard deviation and every individual time. Paid plans can also set a custom timeout in milliseconds. Private, loopback and other non-public addresses are refused, so only hosts on the public internet can be pinged.

How it works

The API runs the system ping utility against host, one probe per round trip and one after another, and records the reply time of each probe that is answered. host must be a valid hostname or IP address that resolves to a public address; private ranges, loopback and similar targets return 400. A name that cannot be resolved is still attempted and comes back not alive.

roundTrips sets how many probes are sent, 1 to 5, default 1. timeout is given in milliseconds (100-3000, default 1500), but ping waits in whole seconds, so the value is rounded up: 100-1000 waits 1 second per probe, 1001-2000 waits 2 and 2001-3000 waits 3. Free plan calls always use the default, a 2-second wait.

alive is true when at least one probe was answered, and roundTrips in the response is the number answered, not the number sent. packetLoss is the unanswered share times 100 and is not rounded, so one loss in three reads 33.33 and more digits. minMS, avgMS and maxMS summarise times, the per-probe round trips in milliseconds, and stdDev is their population standard deviation.

If every probe fails, alive is false, packetLoss is 100, the timing fields are null and times is empty. Every requested probe is sent even when some fail, so a down or lossy host returns a normal success response with its packetLoss; an error status means the check itself failed. A URL or host:port in host is reduced to the hostname first, since ICMP has no port. numericHost is the IP ping resolved, or unknown. Many hosts drop ICMP deliberately, so not alive can mean a firewall rather than an outage. On the Free plan numericHost, packetLoss and every timing field are null.

What people use it for

Server Reachability Checks
DevOps engineers trigger ping checks during deployments to confirm that newly provisioned web servers respond before routing production traffic to them.
Network Latency Monitoring
When network engineers detect sluggish connections, they inspect round-trip responses across public IP endpoints to diagnose potential packet drop issues.
Domain Availability Verification
To catch outages fast, internal status dashboards poll critical external third-party hostnames and display immediate alive indicators to support staff.
Automated Incident Triage
Alerting systems ping reported remote servers to verify reachability before paging on-call staff for an offline alert.

Without writing code

Latency Checker Widget for Windows keeps your ping on the desktop.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON
Default REST response
XML
Markup format
YAML
Human-readable
CSV
Tabular export
Beta
GraphQL
Query language
New
MCP
For AI agents

Other ways to use Domain and IP Pinger

Same data, same APIVerve account, same credit balance — one key works on all of them.

Questions.

Common questions about the Domain and IP Pinger API.

Read the docs →
Can I test both domain names and public IP addresses?
Yes. Dedicated endpoints accept either standard hostnames or public IP addresses. You submit the host string to verify whether the target is responding to network requests.
Can I adjust how many pings are sent in a single check?
Yes. You can supply the roundTrips parameter to choose how many ping attempts are made before the results are averaged. On paid plans, you can also set a custom timeout threshold in milliseconds.
Are latency metrics and packet loss percentages included on the Free plan?
No. The Free plan only returns the basic reachability status and round trip count. Latency metrics including minimum, average, maximum times, standard deviation, individual ping times, packet loss, and custom timeouts require a paid plan.
Which plan fits pinging 50,000 servers a month?
The Starter plan handles this volume. Each check costs 2 credits, so 50,000 pings consume 100,000 credits, leaving half of Starter's 200,000 monthly credits available. That works out to about $0.30 per 1,000 calls. The Free plan provides 100 checks each month for testing.
Can I display these ping results inside a commercial monitoring tool?
Yes, commercial use is allowed on any paid plan. You can incorporate reachability and latency results directly into your own status dashboards, alerting systems, or internal tools. Reselling the raw response data directly is prohibited.

Ready to build with Domain and IP Pinger? Start with 200 free credits — one key unlocks all 300+ APIs.

Explore the catalog

300+ APIs on the same key and the same response shape.

Browse all APIs