---
title: "corestack_company_snapshots_list"
url: https://docs.corefinity.com/mcp/tools/corestack_company_snapshots_list
type: tool
last_updated: 2026-11-13
feature: restores
related:
  - https://docs.corefinity.com/guides/sites/backups/restore-anywhere.md
---
# corestack_company_snapshots_list

**Your company's snapshots.** Every snapshot of your company's websites and environments, newest first, 50 a page: kind, size, versions, note, expiry, whether it is kept or in use and whether it can be restored, with the Keep allowance. Scope: read.

- Scope: `read`
- Runs as a task: no

## When to use it

Browse every snapshot your company holds, across all its websites and environments, to find one to restore or copy from: newest first, 50 a page. Each snapshot shows when it was taken, its status, kind, size, the versions it holds, its note, when it expires, whether it is kept (protected from expiry) or in use, whether it can be restored, and its website and environment. The `keep` block is how much of the Keep allowance is used. A token with pins sees only the websites its pins cover.

## Inputs

- `site_id` (integer, optional): a website: its production row and its environments.
- `environment_id` (integer, optional): one environment.
- `kind` (string, optional): `scheduled`, `manual`, `pre_restore`, `final`, `clone` or `pre_deploy`.
- `from` (string, optional): the first day, `YYYY-MM-DD` in UTC.
- `to` (string, optional): the last day, `YYYY-MM-DD` in UTC, not before `from`.
- `kept` (boolean, optional): only kept snapshots (true) or only the others (false).
- `cursor` (string, optional): the `next_cursor` of the page before; null there means the last page.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "maxLength": 512,
      "type": "string"
    },
    "environment_id": {
      "minimum": 1,
      "type": "integer"
    },
    "from": {
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "type": "string"
    },
    "kept": {
      "type": "boolean"
    },
    "kind": {
      "enum": [
        "scheduled",
        "manual",
        "pre_restore",
        "final",
        "clone",
        "pre_deploy"
      ],
      "type": "string"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    },
    "to": {
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "type": "string"
    }
  },
  "type": "object"
}
```

## Refusals

- `invalid_arguments`: a cursor that is not one of ours, or `to` before `from`; start again from the first page.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_company_snapshots_list",
  "arguments": {
    "site_id": 300,
    "kept": true
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_snapshots_list with site_id 300, kept true. (Your company's snapshots.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Restore anywhere](https://docs.corefinity.com/guides/sites/backups/restore-anywhere.md)
