List your demos
The demos of your company, and of the companies your agency manages, newest first; one that failed while it was being set up is not listed. You need two-factor authentication set up, whatever your company requires. Paged by cursor: send next_cursor back as cursor; null means the last page.
Query parameters
Items a page: 1 to 50, default 20.
The next_cursor of the previous answer. Digits only; anything else is refused 422 on cursor.
Returns
200 One page of demos.
Fields of the 200 answer
Send as cursor to read the next page. Null on the last page.
Fields of each item
Whole days until the demo ends. null unless the demo is active.
Format: date-time.
Until when an ended demo can still be kept. Format: date-time.
At least 1.
Fields
Whether you could keep it now.
Why you cannot keep it now, as Keep would refuse it. null when you can, while it is building, and once it is kept or closed.
The Keep page in the Control Panel. Format: uri.
Format: date-time.
The package the demo is on, such as CS4.
What it costs a month once kept as it is. null when it cannot be priced.
CS for a CoreStack site, CC for a CoreCluster.
The region's code, such as uk.
Format: date-time.
building while it is set up, active while it runs, ended once its time is up and it waits in its grace period, kept, or closed.
buildingactiveendedkeptclosedWhat the demo is of.
Fields
The site row's id or the CoreCluster's id. At least 1.
The site's domain or the cluster's name.
siteclusternullFields
The changes of a Keep that still wait to be applied, as a short token. null when nothing waits.
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. |
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/demos \
-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/demos');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/demos', {
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/demos",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"data": [
{
"days_left": 27,
"ends_at": "2026-12-06T09:00:00Z",
"grace_ends_at": null,
"id": 3310,
"keep": {
"allowed": true,
"refusal": null,
"url": "https://manage.corefinity.com/billing/keep?demo=3310&plan=keep"
},
"kept_at": null,
"package": "CS4",
"price_after": {
"amount": "300.00",
"currency": "GBP"
},
"product_line": "CS",
"region": "uk",
"starts_at": "2026-11-06T09:00:00Z",
"state": "active",
"target": {
"id": 1051,
"name": "journal.harbourandfinch.example.com",
"type": "site"
},
"upgrade": {
"next": null
}
}
],
"next_cursor": null
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "invalid",
"errors": {
"limit": [
"The limit may not be greater than 50."
]
},
"field": "limit",
"message": "The limit may not be greater than 50.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}