Probes report Beta
GET /api/v1/monitors/{id}/probes
Which locations checked the monitor in the window, how often, and how fast it responded from each.
Needs an X-API-Key header whose owner has access to uptime monitoring in the app. The call counts once against your daily quota. See Monitoring API: getting started for authentication, rate limits and errors.
Query parameters
| Name | Type | Description |
|---|---|---|
from optional | string | integer | Start of the window. Default: 7 days before to. |
to optional | string | integer | End of the window. Default: now. The window can be up to 1830 days. |
Request
Response
200 · application/json
- {
- "id": "mon_79ce3cf9c4fa56e98af4",
- "from": "2026-09-10T09:31:00.000Z",
- "to": "2026-09-17T09:31:00.000Z",
- "probes": [
- { "region": "default", "label": "United Kingdom", "checks": 336, "upChecks": 335,
- "avgResponseMs": 188, "lastCheckedAt": "2026-09-17T09:30:04.221Z" },
- { "region": "eu", "label": "Europe", "checks": 336, "upChecks": 336,
- "avgResponseMs": 241, "lastCheckedAt": "2026-09-17T09:15:03.870Z" }
- ],
- "usage": { "used": 26, "dailyLimit": 100, "tier": "free" }
- }
Locations are sorted by number of checks, busiest first, and only locations that ran at least one check are listed. avgResponseMs uses successful checks only. lastCheckedAt is null for windows longer than 92 days, which are read from daily totals.
Errors
| Status | When |
|---|---|
400 | from or to isn't a valid time, from isn't before to, the window is too long. |
401 | The API key is missing or invalid. |
403 | The key's owner doesn't have access to uptime monitoring, or the key isn't linked to a workspace. |
404 | No monitor with that id in your workspace. |
405 | The endpoint doesn't accept that method. |
429 | A rate limit or your daily quota was hit. Read Retry-After, in seconds. |
500 | Something went wrong on our side. Try again. |
503 | The API is temporarily unavailable. Try again shortly. |
Errors are JSON: { "error": "message" }. See Monitoring API errors.
Related
- Reports: how the reports count time
- Monitor settings: choose where checks run from
- Results: filter raw checks by location