Get a demo
One demo, with the packages you could keep it on (upgrade_options, priced) and, once it is kept, where each change the Keep asked for stands (progress). A demo of a company you cannot see answers the same 404 as an id that does not exist.
Path parameters
The id of a demo, as the list gives it. Digits only. At least 1.
Returns
200 The demo.
Fields of the 200 answer
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.
Where each change a Keep asked for stands. They are applied one at a time, in the order listed. It is not the shared ProgressStage: a change has a plan and a kind in place of a key and a label, and the times of its start and its end.
Fields
Fields of each item
Format: date-time.
A package, a server type, or add-on units.
packagefamilyaddonsThe operation that applies the change, once it has started. Follow it with GET /. A CoreCluster's server type change has none. At least 1.
The change as a short token, such as cs8 or cores2.
Format: date-time.
waitingapplyingdonefailedstartedThe changes still waiting, as a short token such as cores2. null when nothing waits.
none when the Keep asked for no change, applying while any change waits or runs, done when every one landed, failed when one did not (the kept price stands), started when a change started and there is nothing to follow it by.
noneapplyingdonefailedstartedThe packages the demo can be kept on, from its own upwards, each with its monthly price. Empty once the demo is kept or can no longer be kept.
Fields of each item
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/demos/3310 \
-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/3310');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/demos/3310', {
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/3310",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"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",
"progress": {
"changes": [],
"next": null,
"state": "none"
},
"region": "uk",
"starts_at": "2026-11-06T09:00:00Z",
"state": "active",
"target": {
"id": 1051,
"name": "journal.harbourandfinch.example.com",
"type": "site"
},
"upgrade": {
"next": null
},
"upgrade_options": [
{
"monthly": {
"amount": "300.00",
"currency": "GBP"
},
"package": "CS4"
},
{
"monthly": {
"amount": "450.00",
"currency": "GBP"
},
"package": "CS6"
},
{
"monthly": {
"amount": "600.00",
"currency": "GBP"
},
"package": "CS8"
}
]
}{
"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
}