Developer Reference

Diagnostic & Telemetry API

VelocityVerify provides high-throughput, edge-distributed HTTP endpoints designed for active broadband measurement, round-trip latency probing, and multi-CDN queue telemetry.

Architecture & Global Standards

All endpoints are served over HTTP/2 and HTTP/3 with transport encryption (TLS 1.3). Cross-Origin Resource Sharing (CORS) is enabled globally with permissive headers to allow browser workers and telemetry scripts to measure network conditions without origin friction.

CORS Header Guarantee: Every endpoint returns Access-Control-Allow-Origin: * and Timing-Allow-Origin: *, permitting Resource Timing API extraction in modern diagnostic browsers.

Public Diagnostic Endpoints

GET /api/health

Checks the operational status of the nearest measurement node, clock synchronization, and telemetry pipeline availability.

HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 Cache-Control: no-store, no-cache, must-revalidate { "status": "healthy", "version": "5.5.1", "timestamp": 1740000000000, "node": "iad-edge-01" }
GET /api/getIP

Resolves client network transport metadata, including public IP, detected ISP Autonomous System Number (ASN), and coarse geographic region.

HTTP/1.1 200 OK Content-Type: text/plain; charset=utf-8 203.0.113.42 - Seattle, WA (Charter Spectrum - AS20115)
GET POST /api/empty

Zero-payload round-trip probe. When called via GET, it returns an empty body (0 bytes) with zero cache to measure pristine round-trip time (RTT) and bufferbloat latency deltas under saturation. When called via POST, it consumes uploaded byte streams without disk I/O to benchmark upstream throughput.

HTTP/1.1 200 OK Content-Length: 0 Cache-Control: no-store, no-cache, must-revalidate Timing-Allow-Origin: *
GET /api/garbage?ckSize={size}

Streams synthetic pseudorandom bytes engineered to resist inline hardware compression. Diagnostic workers open 4 to 16 concurrent HTTP streams against this endpoint to fill the TCP bandwidth-delay product (BDP).

Query Parameters: ckSize (integer between 1 and 100, representing megabytes per chunk).

curl -s -o /dev/null -w "Connect: %{time_connect}s | Speed: %{speed_download} B/s\n" \ "https://www.velocityverify.com/api/garbage?ckSize=10"
POST /api/results

Ingests anonymized diagnostic summaries to power the Global ISP Performance Index. Does not record full IP addresses or personal identifiers.

{ "timestamp": "2026-09-22T12:00:00.000Z", "downloadMbps": 384.2, "uploadMbps": 41.5, "idleLatencyMs": 14, "jitterMs": 2, "bufferbloat": { "grade": "A", "deltaMs": 11 }, "isp": "Verizon Fios" }

Rate Limiting & Acceptable Use

To prevent denial-of-service and preserve test fairness, edge nodes enforce a tiered token-bucket rate limiter:

For custom telemetry integrations or dedicated test nodes, review our Methodology or reach out via our Contact Us page.