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
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | none | Check the id. You see only what your account can reach. |
429 | rate_limited | Wait 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"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/regions');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/regions', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/corestack/regions",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"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"
}
]
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"message": "Not found."
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it
Was this helpful?