> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syntage.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Exports

Exports create downloadable files from Syntage data. Use them when your integration needs a file that can be stored, shared, imported into another system, or delivered to an operations team.

Creating an export starts asynchronous processing and returns an Export resource. The export keeps track of the requested source data, output format, processing status, and generated file.

## How Exports Work

1. Create an export with the collection URI and output format you need.
2. Store the returned export ID.
3. Retrieve the export until its `status` is `finished` or `failed`.
4. Download the generated file from the File resource referenced by the export.

Exports are useful for workflows such as finance reports, invoice handoffs, customer support investigations, back-office review, and scheduled data delivery.

## Viewing your exports

Browse your exports in the [dashboard](https://app.syntage.com/settings/exports), or list them with [`GET /exports`](https://docs.syntage.com/api-reference/exports/list-all-exports). Both return only the exports you created, not those created by other users in your organization.

## Report PDF exports

Besides collection exports in `csv`, `xlsx`, or `json` format, exports can also generate a PDF document of an entity [report](https://docs.syntage.com/resources/insights/reports.md). Set `format` to `pdf` and `uri` to `/entities/{entityId}/reports/{reportId}?exporting=true`; the finished export references a `report.insights.pdf` file. The `exporting=true` query parameter is required and is the only supported query parameter on report URIs. See [Reports](https://docs.syntage.com/resources/insights/reports.md) for the full flow.

For endpoint details, see [Exports API Reference](https://docs.syntage.com/api-reference/exports/export-data.md).

| Status | Meaning |
| - | - |
| `pending` | The export has been accepted and is waiting to run. |
| `running` | Syntage is building the export file. |
| `finished` | The export file is ready to download. |
| `failed` | The export could not be completed. Create a new export after correcting the request. |

> [!TIP]
>
> The export response references a File resource when the generated file is ready. Use the file metadata to inspect the filename, media type, and size before downloading it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.