---
title: Locations
description: GET /v1/locations — the catalog of probe locations you can attach to a monitor, with city, region and country.
canonical: https://watchfor.io/docs/api/locations
---

# Locations

GET /v1/locations — the catalog of probe locations you can attach to a monitor, with city, region and country.

| Method | Path | Scope | operationId |
| --- | --- | --- | --- |
| GET | `/v1/locations` | read | `listLocations` |

The location object:

```json
{
  "id": "9f31c2ab-…",
  "object": "location",
  "name": "Stockholm, Sweden",
  "city": "Stockholm",
  "region": "Europe",
  "country": "Sweden",
  "country_code": "SE"
}
```

## List locations

`GET /v1/locations` — every active public probe location, sorted by
region and then name. Not paginated (`has_more` is always `false`). Use
the `id` values in the `locations` array when
[creating](/docs/api/monitors#create-a-monitor) or
[updating](/docs/api/monitors#update-a-monitor) a monitor.

```bash
curl https://watchfor.io/api/v1/locations \
  -H "Authorization: Bearer wf_live_YOUR_KEY"
```

```json
{
  "object": "list",
  "data": [ { "id": "9f31c2ab-…", "object": "location", "name": "Stockholm, Sweden", "…": "…" } ],
  "has_more": false
}
```

WatchFor runs probes in 20 locations across 7 world regions (Europe,
Asia, Middle East, North America, South America, Oceania, Africa); the
human-readable list is on [Probe locations](/docs/reference/probe-locations).
The `region` value is what plan limits on regions count.

## Plan rules

How many locations and regions a single monitor may use, and whether
`parallel` scheduling is available, depends on your plan
(`max_locations`, `max_regions`, `max_parallel_monitors`,
`allowed_strategies` on [`GET /v1/plan`](/docs/api/plan)). The limits are
enforced when a monitor is created or updated, with a `403` naming the
limit — this list itself is always the full catalog.

`heartbeat` monitors take no locations: your job pings WatchFor, not the
other way round.

## Also via

MCP tool `list_locations`; A2A skill `list-locations`. A short sample is
available without a key at
[`GET /api/v1/sandbox/locations`](https://watchfor.io/api/v1/sandbox/locations).

---

Canonical page: https://watchfor.io/docs/api/locations · All docs: https://watchfor.io/docs · Site guide: https://watchfor.io/llms.txt