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

# Reports

> Generate PDF reports of your exposure — a premium research report or a credential comparison — on demand or on a schedule.

A report is a generated **PDF** of an organization's exposure. There are two kinds — pick the one that fits, generate it, then track it and download the file.

<Info>
  Reports have their own PDF generation and download flow. For search-result exports, monitoring match downloads, and original leak-file downloads, see [Downloads and exports](/api/guides/downloads-exports).
</Info>

<Warning>
  The legacy quick-report endpoints `generate_extended_report`, `generate_simple_report`, and `generate_spr_simple_report` are **deprecated and will be removed on 13 July 2026**. Migrate to the **Premium report** (replaces the extended and simple reports) or the **Credential comparison report** below.
</Warning>

<CardGroup cols={2}>
  <Card title="🔬 Premium report" href="/api/guides/reports-premium">
    A full exposure report for one domain over a period — leaks, credentials, cloud storage, forums, apps, and more — benchmarked against your industry, size, and country.
  </Card>

  <Card title="👥 Credential comparison report" href="/api/guides/reports-credential-comparison">
    Compare the leaked credentials found across a set of domains over a period — on demand or on a monthly schedule.
  </Card>
</CardGroup>

Both report types generate the same way and share the steps below.

### Track and download

Generating a report returns a `report_id` and runs asynchronously, moving through `started` → `in_progress` → `ready` (or `error`). Poll [`get_report_status`](https://client-api.leak.center/scalar-docs/#tag/report/GET/service/get_report_status/\{report_id}/) with that id until it's ready — the response carries the `id`, `type`, a human-readable `status` (e.g. *Report ready*), and `metadata` (the domain and period):

```bash theme={"dark"}
curl "https://client-api.leak.center/api/service/get_report_status/REPORT_ID/" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

Once it reads `ready`, fetch the PDF with [`download_report`](https://client-api.leak.center/scalar-docs/#tag/report/GET/service/download_report/\{report_id}/):

```bash theme={"dark"}
curl "https://client-api.leak.center/api/service/download_report/REPORT_ID/" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -OJ
```

Period dates (`from_date` / `to_date`) use **`dd-mm-yyyy`**; the record timestamps `created_at` and `updated_at` include the time (`dd-mm-yyyy HH:MM:SS`).

### List and delete

See all your reports with [`list_report_requests`](https://client-api.leak.center/scalar-docs/#tag/report/GET/service/list_report_requests/) — paginated and filterable by `report_type`, `status`, `domain`, and `ordering`. Each row carries `id`, `domain`, `status`, `type`, `from_date` / `to_date`, `frequency` (`on_demand` for a one-off, `monthly` for one produced by a [schedule](/api/guides/reports-credential-comparison)), and `created_at` / `updated_at`. Remove one you no longer need with [`delete_report`](https://client-api.leak.center/scalar-docs/#tag/report/DELETE/service/delete_report/\{report_id}/).