List your sites
Every site you can open, one entry per site with its environments, in id order. Paged by cursor: send next_cursor back as cursor; null means the last page.
Query parameters
Only the sites of this CoreCluster. A CoreCluster that is not yours answers 404. At least 1.
Only sites of this platform. Only the platforms available to your company are accepted.
wordpresslaravelmagento2shopware5corecluster for sites in one of your CoreClusters, corestack for standalone CoreStack sites.
coreclustercorestackPart of a domain or of an environment name. Up to 120 characters.
security for sites on an application version that receives security fixes only, eol for sites on an ended version. Accepted only while application versions are on for your company; otherwise it is refused 422 on app_status.
securityeolItems a page: 1 to 100, default 50.
The next_cursor of the previous answer. One with other characters, or longer than 64, is refused 422 on cursor; any other value that is not a cursor reads the first page.
Returns
200 One page of sites.
Fields of the 200 answer
Send as cursor to read the next page. Null on the last page.
Fields of each item
healthydegradeddownapplyingunknownnot_liveFields
customer for a site in one of your CoreClusters, platform for a standalone CoreStack site.
The site row id, the {site} of every /corestack/sites/{site} endpoint.
On a read (a site, the list of sites, a CoreCluster's sites, the overview): corecluster for a site in one of your CoreClusters, corestack for a standalone CoreStack site. The answer to a change that carries the row, such as creating a site, can send corestack for either; hosting.cluster_kind tells the two apart on every answer.
coreclustercorestackFields
Fields
production once a domain is attached, staging before.
productionstagingunknownThe change running on the row now, or null.
The package of a standalone CoreStack site, with its key, code and name. Null for a CoreCluster site.
The changes waiting for the row's next maintenance window.
Fields
Fields
Fields
The row's own address on the platform.
The restore running on the row now, or null.
The site the row belongs to. For a production row, the row itself.
The row's platform identifier.
A summary of the row's snapshots.
Fields
The size of the row, such as S, M or L.
The size of a staging environment. Null for a production row.
Fields
A cluster by its id and name. A standalone CoreStack site reads CoreStack as the name.
Fields
Always true on this endpoint.
How many environments the site has besides production.
Every row of the site, the production row first.
Fields of each item
The environment's platform identifier.
The environment's own address on the platform.
The site row id, the {site} every /corestack/sites/{site} endpoint takes.
The environment's role, such as production or staging.
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. |
422 | invalid | Fix the field named in field; errors says why. |
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/sites \
-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/sites');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites', {
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/sites",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"next_cursor": null,
"sites": [
{
"cluster": {
"id": 1017,
"name": "Northwind UK 1"
},
"compute_family": "general",
"covers_site": true,
"domain": "harbourandfinch.example.com",
"environment": {
"env_id": "rs-northwind-harbourandfinch-example-com",
"hostname": "harbourandfinch-example-com.northwind.cfstack.example.net",
"id": 1042,
"name": "Production",
"role": "production",
"role_label": "Production",
"slug": "production"
},
"environment_count": 1,
"environments": [
{
"env_id": "rs-northwind-harbourandfinch-example-com",
"hostname": "harbourandfinch-example-com.northwind.cfstack.example.net",
"id": 1042,
"name": "Production",
"role": "production",
"role_label": "Production",
"slug": "production"
},
{
"env_id": "rs-northwind-harbourandfinch-example-com--staging",
"hostname": "staging-harbourandfinch-example-com.northwind.cfstack.example.net",
"id": 1043,
"name": "Staging",
"role": "staging",
"role_label": "Staging",
"slug": "staging"
}
],
"health": "healthy",
"hosting": {
"cluster_kind": "customer",
"label": "CoreCluster Northwind UK 1"
},
"id": 1042,
"kind": "corecluster",
"limits": {
"cpu_millicores": 2000,
"disk_bytes": 10737418240,
"memory_bytes": 4294967296
},
"logs": null,
"mariadb": {
"version": "11.8"
},
"mode": "production",
"mode_label": "Domain attached",
"operation": null,
"package": null,
"pending_changes": {
"count": 0,
"outcome_at": null,
"state": null,
"window_starts_at": null
},
"php": {
"version": "8.3"
},
"platform": {
"key": "wordpress",
"label": "WordPress"
},
"platform_url": "https://harbourandfinch-example-com.northwind.cfstack.example.net",
"primary_url": "https://harbourandfinch.example.com",
"removed": false,
"restore": null,
"site": {
"domain": "harbourandfinch.example.com",
"id": 1042
},
"site_id": "rs-northwind-harbourandfinch-example-com",
"snapshots": {
"count": 0,
"effective_frequency": "off",
"effective_label": "Off",
"latest": null,
"latest_ready_at": null,
"next_scheduled_at": null,
"overridden": false,
"stored_gb": 0
},
"tier": "S",
"uat_size": null,
"usage": {
"cpu_millicores": 180,
"disk_used_bytes": 2147483648,
"memory_bytes": 912261120,
"observed_at": "2026-11-14T09:10:00Z",
"source": "live"
}
}
]
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"message": "Not found."
}{
"code": "invalid",
"errors": {
"limit": [
"The limit may not be greater than 100."
]
},
"field": "limit",
"message": "The limit may not be greater than 100.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}