List a site's snapshots
Answers the site's snapshots, newest first, with its snapshot settings and any restore still running. The list is not paged; a snapshot deleted in the last day is still listed.
Path parameters
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.
Returns
200 The snapshots, the settings and the running restore, if any.
Fields of the 200 answer
The restore still running on the site, as GET /corestack/restores/{restore} answers it, or null.
One site's snapshot settings.
Fields
The default the site follows, its CoreCluster's or, for a CoreStack site, its package's.
1h2h3h4h6h12hdailyweeklymonthlyoffHow often scheduled snapshots are taken.
1h2h3h4h6h12hdailyweeklymonthlyoffWhether snapshots are enabled for the site.
The site's own frequency. Null while it follows the default.
Fields of each item
How often scheduled snapshots are taken.
1h2h3h4h6h12hdailyweeklymonthlyoffThe latest scheduled snapshot, if it failed and will not be tried again.
How many more one-off snapshots can be taken this hour.
Format: date-time.
True for a CoreStack site, whose quota figures below are its own package's, measured over the site and its environments. False for a site on a CoreCluster, where the figures below are null, 0 or false and the CoreCluster's snapshot settings carry them.
Where the schedule and the retention come from: the site's package, its CoreCluster (cluster), or the schedule kept for a site moved from CoreStack Enterprise (cse_move). Null when the site has none.
The most space kept snapshots may use.
The space kept snapshots use.
True when the quota removed snapshots in the last 24 hours.
How many days a snapshot is kept before retention removes it. Null when no retention is set.
Null until sizes have been measured for the first time.
Format: date-time.
Fields of each item
True for a snapshot kept from before the site moved storage. Only Corefinity support can restore it.
Whether it can be used as a source now. Sent only while restoring to another environment is on for your company.
Whether you can delete it now.
Whether you can keep it, or stop keeping it, now.
Format: date-time.
Why the snapshot was deleted. Null until a delete is asked for.
Format: date-time.
Why the snapshot failed, in plain words.
When retention removes the snapshot. Null while it is kept or no retention is set. Format: date-time.
At least 1.
Whether a restore or a copy is reading it. Sent only while restoring to another environment is on for your company.
The same as protected. Sent only while restoring to another environment is on for your company.
Why the snapshot was taken.
scheduledmanualpre_restorefinalclonepre_deployTrue while the snapshot is kept.
Format: date-time.
What the snapshot can be restored as now, and why not when it cannot.
Fields
Why something cannot be restored, in plain words.
The size of the site the snapshot restores to. Null until it is known.
retrying is a scheduled snapshot that failed and will be tried again; retried is a failed attempt that a later one replaced.
pendingcreatingreadyfaileddeletingdeletedretryingretriedThe space the snapshot uses. Null until it is measured.
Why it cannot be used as a source. Sent only when available is false.
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/sites/1042/snapshots \
-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/sites/1042/snapshots');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/snapshots', {
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/sites/1042/snapshots",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"restore": null,
"settings": {
"cluster_frequency": "6h",
"cluster_label": "Every 6 hours",
"effective_frequency": "6h",
"effective_label": "Every 6 hours",
"enabled": true,
"frequency": null,
"frequency_options": [
{
"label": "Every hour",
"value": "1h"
},
{
"label": "Every 2 hours",
"value": "2h"
},
{
"label": "Every 3 hours",
"value": "3h"
},
{
"label": "Every 4 hours",
"value": "4h"
},
{
"label": "Every 6 hours",
"value": "6h"
},
{
"label": "Every 12 hours",
"value": "12h"
},
{
"label": "Daily",
"value": "daily"
},
{
"label": "Weekly",
"value": "weekly"
},
{
"label": "Monthly",
"value": "monthly"
},
{
"label": "Off",
"value": "off"
}
],
"last_scheduled_failed": null,
"manual_remaining_this_hour": 19,
"next_scheduled_at": "2026-11-03T17:23:00Z",
"over_quota": false,
"per_site": false,
"policy_source": "cluster",
"protect_cap_bytes": null,
"protected_bytes": 0,
"pruned_recently": false,
"quota_bytes": null,
"retention_days": 30,
"usage_bytes": null,
"usage_synced_at": null
},
"snapshots": [
{
"archived": false,
"can_delete": true,
"can_protect": true,
"created_at": "2026-11-03T15:12:40Z",
"delete_reason": null,
"delete_reason_label": null,
"deleted_at": null,
"error": null,
"expires_at": "2026-12-03T15:12:40Z",
"id": 3301,
"kind": "manual",
"kind_label": "One-off",
"mariadb_version": "11.8",
"note": "Before the PHP 8.4 move",
"php_version": "8.3",
"protected": false,
"ready_at": "2026-11-03T15:14:02Z",
"requested_by": {
"id": 2041,
"name": "Eleanor Finch"
},
"restorable": {
"database": true,
"everything": true,
"files": true,
"reason": null
},
"restore_size_bytes": 6442450944,
"status": "ready",
"status_label": "Ready",
"stored_bytes": 1288490188
}
]
}{
"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
}