> ## 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.

# Reports

> Reports group entity insights into a configurable layout that can be viewed in the dashboard and downloaded as a PDF.

Reports group [insights](/resources/insights/overview) into a named, ordered layout for one entity. The same report definition works for every entity in your organization: open it from the entity's Reports section in the dashboard, or download it as a PDF document with the [Exports API](/resources/core/exports).

## Built-in and custom reports

| Type                    | Who manages it                                                           | Visibility                     |
| ----------------------- | ------------------------------------------------------------------------ | ------------------------------ |
| Built-in                | Syntage; kept up to date automatically and cannot be modified or deleted | Every user                     |
| Custom (personal)       | The user who created it                                                  | Only the owner                 |
| Custom (organizational) | Admins                                                                   | Every user in the organization |

Built-in reports such as `full_report` cover the standard credit-review layout: company summary, Syntage Score, risk indicators, corporate structure, revenue, financial statements, clients, and providers.

Custom reports select and order the insight entries you care about. Create one with `POST /reports`, setting `organizational` to `true` to share it with your organization.

Insight entries gated by a feature flag that is disabled for your organization are omitted from the report layout.

## Download a report as a PDF

Report PDFs are generated asynchronously through the [Exports API](/resources/core/exports):

1. List your reports with `GET /reports` and store the ID of the report you want.
2. Create an export with `format` set to `pdf` and `uri` set to `/entities/{entityId}/reports/{reportId}?exporting=true`.
3. Retrieve the export until its `status` is `finished`.
4. Download the generated `report.insights.pdf` file from the File resource referenced by the export.

```json theme={null}
POST /exports
{
  "format": "pdf",
  "uri": "/entities/91106968-1abd-4d64-85c1-4e73d96fb997/reports/9137b53f-1abd-4d64-85c1-4e73d96fb997?exporting=true"
}
```

The generated PDF renders the report the same way the dashboard shows it to the requesting user: it uses the user's locale, the report's default period, and only the insight sections visible to that user. The `exporting=true` query parameter is required; other query parameters are not supported on report URIs.

<Note>
  PDF generation renders every insight in the report, so it can take a few minutes for entities with large datasets. Poll the export status instead of assuming a fixed completion time.
</Note>

For endpoint details, see the [Reports API Reference](/api-reference/reports/list-reports).