---
title: "List checker IP addresses"
method: GET
path: "/checker-addresses"
tags: ["Checkers"]
---

# List checker IP addresses

`GET /checker-addresses`

## Request

- Base URL: `https://api.spectate.net/v1`
- URL: `https://api.spectate.net/v1/checker-addresses`
- Auth: HTTP bearer

Returns the IP addresses that uptime checks come from, per region. They are the same for
every team. A monitor only sends checks from the regions that it uses, and a check can come
from the IPv4 or the IPv6 address of a region, so allow both. Any valid token may call it.

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Paginated set of `CheckerAddress`

- object
  - `current_page` integer, required
  - `data` CheckerAddress[], required
    - `location` 'eu' | 'us' | 'as' | 'oc', required: A region checks run from. A monitor's primary region decides its uptime and alerts (a failed check is repeated from the same region about 5 seconds later before it is marked down); on the Team plan and up the other regions can also measure its response time. | | |---| | `eu` <br/> Europe. | | `us` <br/> North America. | | `as` <br/> Asia. | | `oc` <br/> Oceania. |
    - `name` string, required: Name of the region
    - `ipv4` string[], required: IPv4 addresses of the region
    - `ipv6` string[], required: IPv6 addresses of the region
  - `first_page_url` string, nullable, required
  - `from` integer, nullable, required
  - `last_page_url` string, nullable, required
  - `last_page` integer, required
  - `links` object[], required: Generated paginator links.
    - `url` string, nullable, required
    - `label` string, required
    - `active` boolean, required
  - `next_page_url` string, nullable, required
  - `path` string, nullable, required: Base path for paginator generated URLs.
  - `per_page` integer, required: Number of items shown per page.
  - `prev_page_url` string, nullable, required
  - `to` integer, nullable, required: Number of the last item in the slice.
  - `total` integer, required: Total number of items being paginated.

## Other responses

- `401`: `UNAUTHENTICATED`: no token was sent. `INVALID_TOKEN`: the token is unknown or revoked. `TOKEN_EXPIRED`: the token has expired.
- `403`: `TEAM_PENDING_DELETION`: the team is scheduled for deletion. `TEAM_SUSPENDED`: Spectate suspended the team.
- `429`: `RATE_LIMITED`: too many requests for this token. Wait for the number of seconds in `Retry-After`.

---

[API](https://skmtc.dev/spectate/apis/spectate-api.md) - [All operations](https://skmtc.dev/spectate/apis/spectate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spectate/apis/spectate-api/revisions/9b1a233997de?raw)