> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-auto-cli-sdk-preview-pr-510.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# vastai show instance-backup-files

List the stored objects of one backup, with direct download URLs.

## Usage

```bash theme={null}
vastai show instance-backup-files CONTRACT_ID [OPTIONS]
```

## Arguments

<ParamField path="contract_id" type="integer" required>
  instance or volume contract id whose backup to list
</ParamField>

## Description

Lists the objects stored for one backup. Each URL already carries a download token
scoped to this backup, so it works on its own -- open it in a browser, or:

curl -o model.safetensors "\<url>"

The token is also printed on its own for the header form, `curl -H "Authorization:
&lt;token&gt;"`, which keeps it out of shell history and proxy logs. Either way it expires
(the lifetime is printed), so re-run this command rather than saving the URLs.

If the listing reports itself truncated, the backup holds more objects than are
shown; restore with `vastai copy vast.CONTRACT_ID:/ INSTANCE_ID:/path` instead of
fetching file by file.

Example: vastai show instance-backup-files 12345678

## Global Options

The following options are available for all commands:

| Option          | Description                                           |
| --------------- | ----------------------------------------------------- |
| `--url URL`     | Server REST API URL                                   |
| `--retry N`     | Retry limit                                           |
| `--raw`         | Output machine-readable JSON                          |
| `--explain`     | Verbose explanation of API calls                      |
| `--api-key KEY` | API key (defaults to `~/.config/vastai/vast_api_key`) |