CorefinityCorefinityDocs
Open the Control PanelControl Panel
Demos · 2 of 3

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.

GET/api/corestack/demos/{demo}

Path parameters

demointegerRequired

The id of a demo, as the list gives it. Digits only. At least 1.

Returns

200 The demo.

Fields of the 200 answer
days_leftinteger or nullRequired

Whole days until the demo ends. null unless the demo is active.

ends_atstring or nullRequired

Format: date-time.

grace_ends_atstring or nullRequired

Until when an ended demo can still be kept. Format: date-time.

idintegerRequired

At least 1.

keepobjectRequired
Fields
allowedbooleanRequired

Whether you could keep it now.

refusalobject or any or nullRequired

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.

urlstringRequired

The Keep page in the Control Panel. Format: uri.

kept_atstring or nullRequired

Format: date-time.

packagestring or nullRequired

The package the demo is on, such as CS4.

price_afterobject or any or nullRequired

What it costs a month once kept as it is. null when it cannot be priced.

product_linestring or nullRequired

CS for a CoreStack site, CC for a CoreCluster.

regionstring or nullRequired

The region's code, such as uk.

starts_atstring or nullRequired

Format: date-time.

statestringRequired

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.

buildingactiveendedkeptclosed
targetobjectRequired

What the demo is of.

Fields
idinteger or nullRequired

The site row's id or the CoreCluster's id. At least 1.

namestring or nullRequired

The site's domain or the cluster's name.

typestring or nullRequired
siteclusternull
upgradeobjectRequired
Fields
nextstring or nullRequired

The changes of a Keep that still wait to be applied, as a short token. null when nothing waits.

progressobjectRequired

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
changesarray of objectsRequired
Fields of each item
ended_atstring or nullRequired

Format: date-time.

kindstringRequired

A package, a server type, or add-on units.

packagefamilyaddons
operation_idinteger or nullRequired

The operation that applies the change, once it has started. Follow it with GET /corestack/operations/{operation}. A CoreCluster's server type change has none. At least 1.

planstringRequired

The change as a short token, such as cs8 or cores2.

started_atstring or nullRequired

Format: date-time.

statestringRequired
waitingapplyingdonefailedstarted
nextstring or nullRequired

The changes still waiting, as a short token such as cores2. null when nothing waits.

statestringRequired

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.

noneapplyingdonefailedstarted
upgrade_optionsarray of objectsRequired

The 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
monthlyobject or any or nullRequired
packagestringRequired

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/demos/3310 \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "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"
    }
  ]
}
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