> For the complete documentation index, see [llms.txt](https://developer.abacum.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.abacum.ai/essentials/concepts/download-links.md).

# Download links

How the data endpoints return files, and how long each link lasts.

Six endpoints return a download link in place of the data. The link is a pre-signed URL to a file in secure storage. This lets you pull large files with standard tools such as curl or an HTTP library.

| Endpoints                                       | Formats      | Link lifetime                      |
| ----------------------------------------------- | ------------ | ---------------------------------- |
| `actuals_data`, `scenario_data`, `rolling_data` | CSV, Parquet | CSV: 30 minutes. Parquet: 2 hours. |
| `raw_data`, `processed_data`                    | CSV, Parquet | CSV: 30 minutes. Parquet: 2 hours. |
| `spaces/{space_id}/tables/{table_id}/data`      | CSV, Parquet | 2 hours in both formats.           |

## Choose the format

| Endpoints                       | Parameter       | Values           | Default |
| ------------------------------- | --------------- | ---------------- | ------- |
| Model data and Space table data | `output_format` | `csv`, `parquet` | `csv`   |
| Dataset data                    | `file_format`   | `csv`, `parquet` | `csv`   |

## Download the file

The link needs no `Authorization` header.

```bash
curl -o data.csv "PRE_SIGNED_URL"
```

When the link expires, call the endpoint again to get a new link.

## Empty results

When a Space table has no data, the `data` field is `null`.

The response format of each file is on [Data file format](/essentials/concepts/data-file-format.md).
