CorefinityCorefinityDocs
Open the Control PanelControl Panel
Sites · 16 of 18

Get a site's usage history

CPU, memory and disk use over a range, as series of points.

GET/api/corestack/sites/{site}/usage

Path parameters

siteintegerRequired

The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.

Query parameters

rangestring

The time range to read. Defaults to 24h.

6h24h7d30d

Returns

200 The usage series.

Fields of the 200 answer
cpuobjectRequired
Fields
limitnumber or null

The most the row can use.

pointsarray of arrays of numbers or nullRequired

One point for each step: the time in epoch milliseconds, then the figures for that step. A figure is null where nothing was measured.

requestnumber or null

The guaranteed amount.

sizenumber or null

The size of the disk.

unitstringRequired
diskobjectRequired
Fields
limitnumber or null

The most the row can use.

pointsarray of arrays of numbers or nullRequired

One point for each step: the time in epoch milliseconds, then the figures for that step. A figure is null where nothing was measured.

requestnumber or null

The guaranteed amount.

sizenumber or null

The size of the disk.

unitstringRequired
fromstringRequired
last_sample_atstring or null
memoryobjectRequired
Fields
limitnumber or null

The most the row can use.

pointsarray of arrays of numbers or nullRequired

One point for each step: the time in epoch milliseconds, then the figures for that step. A figure is null where nothing was measured.

requestnumber or null

The guaranteed amount.

sizenumber or null

The size of the disk.

unitstringRequired
rangestringRequired
6h24h7d30d
sourcestring or null
step_secondsintegerRequired
tostringRequired

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.
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/sites/1042/usage \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "cpu": {
    "limit": 2000,
    "points": [
      [
        1794561000000,
        164,
        310
      ],
      [
        1794561300000,
        171,
        298
      ]
    ],
    "request": 100,
    "unit": "millicores"
  },
  "disk": {
    "points": [
      [
        1794561000000,
        2147483648,
        2147483648
      ],
      [
        1794561300000,
        2147483648,
        2147483648
      ]
    ],
    "size": 10737418240,
    "unit": "bytes"
  },
  "from": "2026-11-13T09:10:00Z",
  "last_sample_at": "2026-11-14T09:05:00Z",
  "memory": {
    "limit": 4294967296,
    "points": [
      [
        1794561000000,
        902261120,
        954261120
      ],
      [
        1794561300000,
        912261120,
        961261120
      ]
    ],
    "request": 536870912,
    "unit": "bytes"
  },
  "range": "24h",
  "step_seconds": 300,
  "to": "2026-11-14T09:10:00Z"
}
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