---
title: "Latency check"
method: GET
path: "/connect/proxies/{id}/ping"
tags: ["Proxies"]
---

# Latency check

`GET /connect/proxies/{id}/ping`

Returns the most recent cached network-latency measurement for the proxy, sampled periodically by connecting through the proxy to a fixed target. `latency` is null when no measurement is available yet (e.g. the proxy is not active, or it has not been sampled since coming online).

## Response `200`

The proxy's latest latency reading.

- ProxyLatency — The latest cached latency reading for a proxy.
  - `latency` LatencySample, required — An aggregated latency measurement taken through the proxy.
    - `avgMs` integer, required — Mean round-trip time over successful probes, in milliseconds.
    - `jitterMs` integer, required — Round-trip time spread (max - min) over successful probes, in milliseconds.
    - `maxMs` integer, required — Maximum round-trip time over successful probes, in milliseconds.
    - `measuredAt` string, date-time, required — When this measurement was taken.
    - `minMs` integer, required — Minimum round-trip time over successful probes, in milliseconds.
    - `packetLoss` number, required — Fraction of probes that failed, 0..1 (1 means the proxy was unreachable; rtt fields are 0).
    - `samples` integer, required — Number of probes taken in this measurement.
    - `target` string, required — The host:port the latency was measured against, through the proxy.
  - `proxyId` string, uuid, required

## Other responses

- `401` — The X-User-ID header was missing or invalid, or a present X-Owner-Id header was not a uuid.
- `404` — The resource was not found.

---

[API](https://skmtc.net/mobilerun/apis/workflows.md) · [All operations](https://skmtc.net/mobilerun/apis/workflows/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobilerun/workflows/revisions/1bc499aa8f99/schema)
