CorefinityCorefinityDocs
Open the Control PanelControl Panel
Packages and capacity · 8 of 12

List regions

Answers every region a CoreCluster can be created in, with whether it is open now and, when it is not, why. package names a CoreCluster package's key, to judge each region's room for that package.

GET/api/corestack/regions

Query parameters

packagestring

A CoreCluster package's key, such as cc8. A package that does not exist answers 404.

Returns

200 The regions.

Fields of the 200 answer
checked_atstringRequired

When the regions were judged. Format: date-time.

regionsarray of objectsRequired
Fields of each item
defaultbooleanRequired
keystringRequired
labelstringRequired
latency_hintstring or nullRequired

Which visitors the region suits.

packagesarray of stringsRequired

The keys of the packages offered there.

placestringRequired

Where the region is.

reasonstring or nullRequired

Why not, in a few words, when it cannot.

statestringRequired

Whether a CoreCluster can be created there now. coming_soon is a region that is not open yet.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404noneCheck the id. You see only what your account can reach.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/corestack/regions \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "checked_at": "2026-11-03T09:00:00+00:00",
  "regions": [
    {
      "default": true,
      "key": "uk",
      "label": "United Kingdom",
      "latency_hint": "Best for visitors in the UK and Ireland",
      "packages": [
        "xsmall",
        "medium",
        "large"
      ],
      "place": "London (europe-west2)",
      "reason": "Available soon",
      "state": "coming_soon"
    },
    {
      "default": false,
      "key": "us",
      "label": "United States",
      "latency_hint": "Best for visitors in North America",
      "packages": [
        "cc4",
        "cc6",
        "cc8"
      ],
      "place": "Ashburn (us-east4)",
      "reason": "Available soon",
      "state": "coming_soon"
    }
  ]
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT