Skip to main content
POST
/
ping
Perform ICMP Ping test on a given URL or IP
curl --request POST \
  --url https://api.geekflare.com/ping \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "url": "https://example.com"
}
'
{
  "timestamp": 1778737930991,
  "apiStatus": "success",
  "apiCode": 200,
  "meta": {
    "url": "example.com",
    "test": {
      "id": "mxqx9v9y0742lap6altwdteqd28t23nq"
    }
  },
  "data": {
    "requests": 4,
    "loss": 0,
    "latency": 32.5,
    "min": 30,
    "max": 35,
    "avg": 32.5,
    "stdDev": 1.5,
    "ip": "142.250.183.206"
  }
}

Authorizations

​
x-api-key
string
header
required

API Key required for all endpoints

Body

application/json
​
url
string
required

Target URL

Example:

"https://example.com"

Response

Ping test completed successfully

​
timestamp
number
required

Timestamp of the request in milliseconds

Example:

1778737930991

​
apiStatus
enum<string>
required

API status message

Available options:
success,
failure
Example:

"success"

​
apiCode
number
required

API status code

Example:

200

​
meta
object
required

Metadata about the Ping test execution

​
data
object
required

Ping result statistics

Example:
{
  "requests": 4,
  "loss": 0,
  "latency": 32.5,
  "min": 30,
  "max": 35,
  "avg": 32.5,
  "stdDev": 1.5,
  "ip": "142.250.183.206"
}