API V1 / Regions / List

List checkpoint regions available on your plan. Use the returned id values in region_ids when creating or updating monitors with region_mode set to selected.

Endpoint

Method	`POST`
Url	`https://downdar.com/api/v1/regions/list`

Request

{}

Response

Top level

`ok`	Always `true` on success.
`regions`	Array of region summary objects available to your account.
`rate_limit`	Rate limit state for the tier this endpoint consumes. Present on every successful response.

regions[]

`id`	Region id. Use this in `region_ids` arrays.
`name`	Display name.
`code`	Short region code.
`is_premium`	`true` when this is a premium checkpoint region.

rate_limit

`tier`	Rate tier this endpoint counts against (`1`-`5`).
`cost`	Units consumed by this request against the tier window.
`timeframe`	Rolling limit window: `second`, `minute`, `hour`, or `day`.
`limit`	Maximum units allowed in the timeframe for this tier on your plan.
`used`	Units already used in the current window.
`remaining`	Units left before this tier returns HTTP 429.

{ "ok": true, "regions": [ { "id": 1, "name": "United States (East)", "code": "us-east", "is_premium": false }, { "id": 2, "name": "Europe (West)", "code": "eu-west", "is_premium": true } ], "rate_limit": { "tier": 2, "cost": 1, "timeframe": "minute", "limit": 120, "used": 73, "remaining": 47 } }