Velohost Velohost

Developer interface

Ping Test API

Check network reachability, latency, and packet loss for hosts or IP addresses.

The Velohost Ping Test API provides a programmatic way to check whether a host or IP address is reachable over the network.

It performs live ICMP echo requests and reports latency and packet loss metrics.

Base API URL

All endpoints listed below are relative to this base URL.

Base API URL https://api.velohost.co.uk/ping-test/

Rate limiting

This API is protected by a global rate limit to ensure fair usage and platform stability.

  • Limit: 30 requests per 10 seconds per IP address
  • Burst traffic is allowed
  • No authentication required
  • Requests exceeding the limit return HTTP 429

This limit applies across all Velohost public APIs.

Error responses

The API uses standard HTTP status codes to indicate errors.

429 Too Many Requests

Returned when the global rate limit is exceeded.

{
  "detail": "Rate limit exceeded"
}
          
400 Bad Request

Returned when the target parameter is missing or invalid.

Endpoints

Ping host or IP

Sends ICMP echo requests to a host or IP address and reports reachability, packet loss, and average latency.

Request
GET /lookup?target=example.com
Response
 
{
  "target": "example.com",
  "reachable": true,
  "packet_loss": 0,
  "avg_latency_ms": 6.562,
  "source": "system_ping"
}

Learn more

Explore the tool, documentation, and guides.