Skip to main content
New to Corsair? See API access, authentication, and error handling.

Health

get

health.get Read the Globalping health check. Risk: read
Input: empty object GET /health. Stores the text body. Output

Limits

get

limits.get Read the current measurement rate limit. Risk: read
Input: empty object GET /v1/limits. Stores the measurements.create bucket. Output

Measurements

create

measurements.create Start a ping, traceroute, dns, mtr or http test from Globalping probes, picked by location. Uses the hourly measurement allowance, then account credits. Risk: write
Input POST /v1/measurements. locations takes filters such as { magic: ‘Germany’, limit: 2 } or { country: ‘US’ }, or the id of an earlier measurement to reuse its probes. measurementOptions holds the options for the chosen type (packets, protocol, port, query, resolver, request). The test runs in the background: read it with measurements.get. Stores id, probesCount, and type.
Output

get

measurements.get Read a measurement by id with each probe’s result. Poll until status is finished. Results are not stored. Risk: read
Input GET /v1/measurements/{id}. Returns one result per probe (probe location plus status, rawOutput, resolvedAddress, stats and the type’s timings, hops or answers). While status is in-progress, wait at least 500 ms and read again. Stores id, type, status, and probesCount; results are returned but not stored. Output

Probes

list

probes.list List online Globalping probes. Probe rows are not stored. Risk: read
Input: empty object GET /v1/probes. Resolver addresses are not returned. Output