Get a CoreCluster's logs usage
Answers the logs quota of the CoreCluster, what is stored, how long lines are kept, 30 days of daily figures and the share of each site you can see. This endpoint is available whenever logs are, also while the other CoreCluster logs endpoints are not.
Path parameters
The id of a CoreCluster. Digits only. At least 1.
Returns
200 The usage.
Fields of the 200 answer
The extra log storage on the owner's contract. Sent only while billing is on for your company, the site or CoreCluster has a usage-billed contract and you may read its billing account.
Fields
What the extra GB cost a month.
Fields
The extra GB on the contract now.
The monthly price of one more GB.
Fields
The share of each environment you can see.
Fields of each item
One environment of a website, addressed by its site row.
Fields
The environment's platform identifier.
The environment's own address on the platform.
The site row id, the {site} every /corestack/sites/{site} endpoint takes.
The environment's role, such as production or staging.
One entry a day for the last 30 days, oldest first, over the environments you can see.
Fields of each item
Format: date.
The lines taken in that day.
Fields
Days until the quota is full at the last week's growth. Null when it cannot be told.
When the oldest lines are next removed to bring the store under its quota. Null while the state is ok. Format: date-time.
Fields
Fields
What the quota belongs to.
Fields
The site (id, domain) or the CoreCluster (id, name).
sitecoreclusterok, warning when the quota is nearly used, over_quota, or unavailable.
okwarningover_quotaunavailableIf 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 | feature_off | This feature is not on for your organisation yet. |
409 | logs_not_collected | Logs are not being collected for the environment yet. Try again later, or contact support. |
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/clusters/1017/logs/usage \
-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/clusters/1017/logs/usage');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/clusters/1017/logs/usage', {
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/clusters/1017/logs/usage",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"by_environment": [
{
"environment": {
"env_id": "harbourandfinch-example-com",
"hostname": "harbourandfinch-example-com.northwind.cfstack.example.net",
"id": 1042,
"name": "Production",
"role": "production",
"role_label": "Production",
"slug": "production"
},
"percent": 61,
"stored_bytes": 61000000000
},
{
"environment": {
"env_id": "journal-harbourandfinch-example-com",
"hostname": "journal-harbourandfinch-example-com.northwind.cfstack.example.net",
"id": 1051,
"name": "Production",
"role": "production",
"role_label": "Production",
"slug": "production"
},
"percent": 39,
"stored_bytes": 39400000000
}
],
"daily": [
{
"day": "2026-11-01",
"ingested_bytes": 12400000000,
"rows": 9800000,
"stored_bytes": 3100000000
},
{
"day": "2026-11-02",
"ingested_bytes": 12800000000,
"rows": 10100000,
"stored_bytes": 3200000000
},
{
"day": "2026-11-03",
"ingested_bytes": 5100000000,
"rows": 4000000,
"stored_bytes": 1270000000
}
],
"forecast": {
"days_to_quota": 6,
"next_enforce_at": "2026-11-04T02:00:00Z"
},
"percent": 84,
"quota": {
"included_gb": 100,
"purchased_gb": 20
},
"quota_gb": 120,
"retention_days": 30,
"stored_gb": 100.4,
"tenant": {
"owner": {
"ref": {
"id": 1017,
"name": "Northwind UK 1"
},
"type": "corecluster"
},
"state": "warning"
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "logs_not_collected",
"message": "Logs are not being collected for this environment yet",
"reason": "logs_not_collected"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}