**Source URL:** https://general.veevavault.dev/vault-api/api-reference/26.1/sandbox-vaults/sandbox-snapshots/retrieve-sandbox-snapshots.md

# Retrieve Sandbox Snapshots



Retrieve information about sandbox snapshots managed by the authenticated Vault.

<Endpoint path="/api/{version}/objects/sandbox/snapshot" method="GET"></Endpoint>

## Headers {#headers}

| Name | Description |
| --- | --- |
| `Accept` | `application/json` (default) or `application/xml` |

## Request {#request}

<CodeExample title="">
```
curl -X GET -H "Authorization: {SESSION_ID}" \
https://myvault.veevavault.com/api/v22.3/objects/sandbox/snapshot

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
   "responseStatus": "SUCCESS",
   "data": {
       "available": 3,
       "snapshots": [
           {
               "name": "Sandbox A Snapshot",
               "api_name": "sandbox_a_snapshot__c",
               "type": "configuration",
               "description": "New snapshot of a sandbox.",
               "status": "active",
               "upgrade_status": "Good",
               "source_sandbox": "SandboxA",
               "total_object_records": 82,
               "document_versions": 0,
               "vault_version": "22R3.2",
               "update_available": "2022-12-03T00:04:59.000Z",
               "created_date": "2022-12-02T00:04:59.000Z",
               "expiration_date": "2023-04-25T05:00:00.000Z",
               "domain": "veepharm.com",
               "created_by": 1006595
           }
       ]
   }
}

```
</CodeExample>

## Response Details {#response-details}

The response contains information about the snapshots managed by the authenticated Vault.

| Name | Description |
| --- | --- |
| `name` | The name of the snapshot. |
| `api_name` | The API name of the snapshot. |
| `type` | The type of the source sandbox, such as `configuration`. |
| `description` | The description of the snapshot. |
| `status` | The current status of the snapshot:`building`: Snapshot is being created or updated`active`: Snapshot is accessible for use`maintenance`: Snapshot is being upgraded`deleted`: Snapshot is expired |
| `upgrade_status` | The current upgrade status of the snapshot:`Good`: No upgrade is required for the snapshot`Upgrade Required`: An upgrade is required for the snapshot`Upgrade Available`: An upgrade is available for the snapshot`Expired`: Snapshot has expired |
| `source_sandbox` | The name of the sandbox Vault the snapshot was created from. |
| `total_object_records` | The total number of object records in the snapshot. |
| `document_versions` | The total number of document versions in the snapshot. |
| `vault_version` | The release version of the source sandbox Vault when the snapshot was created. |
| `update_available` | The date and time when the snapshot can next be updated. Learn more about [updating snapshots in Vault Help](https://platform.veevavault.help/en/gr/535936/#update). |
| `expiration_date` | The date and time when the snapshot will expire. |
| `domain` | The domain of the source sandbox Vault. |


---

**Previous:** [Create Sandbox Snapshot](/vault-api/api-reference/26.1/sandbox-vaults/sandbox-snapshots/create-sandbox-snapshot)  
**Next:** [Delete Sandbox Snapshot](/vault-api/api-reference/26.1/sandbox-vaults/sandbox-snapshots/delete-sandbox-snapshot)