---
title: "POST /ping"
method: POST
path: "/ping"
tags: ["ping"]
---

# POST /ping

`POST /ping`

Perform ICMP Ping test on a given URL or IP

## Request body

- PingDto
  - `url` string, required — Target URL

## Response `200`

Ping test completed successfully

- PingResponseDto
  - `timestamp` number, required — Timestamp of the request in milliseconds
  - `apiStatus` 'success' | 'failure', required — API status message
  - `apiCode` number, required — API status code
  - `meta` PingMetaDto, required
    - `url` string, required — The tested URL or IP address
    - `test` TestMetaDto, required
      - `id` string, required — Unique test identifier
  - `data` PingDataDto, required
    - `requests` number, required — Number of ping requests sent
    - `loss` number, required — Packet loss percentage
    - `latency` number, required — Average latency in milliseconds
    - `min` number, required — Minimum round-trip time (RTT) in milliseconds
    - `max` number, required — Maximum round-trip time (RTT) in milliseconds
    - `avg` number, required — Average round-trip time (RTT) in milliseconds
    - `stdDev` number, required — Standard deviation of RTT in milliseconds
    - `ip` string, required — Resolved IP address of the tested domain

## Other responses

- `400` — Bad request (invalid parameters)
- `500` — Internal server error

---

[API](https://skmtc.net/geekflare/apis/geekflare-api.md) · [All operations](https://skmtc.net/geekflare/apis/geekflare-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geekflare/geekflare-api/versions/936993afc936/schema)