CorefinityCorefinityDocs
Open the Control PanelControl Panel
Demos · 1 of 3

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.

GET/api/corestack/demos

Query parameters

limitinteger

Items a page: 1 to 50, default 20.

cursorstring

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
next_cursorstring or nullRequired

Send as cursor to read the next page. Null on the last page.

dataarray of objectsRequired
Fields of each item
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.

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.
422invalidFix the field named in field; errors says why.
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 \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "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
}
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