Skip to main content
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.
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.
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.

🔬 Premium report

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.

👥 Credential comparison report

Compare the leaked credentials found across a set of domains over a period — on demand or on a monthly schedule.
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 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):
Once it reads ready, fetch the PDF with download_report:
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 — 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), and created_at / updated_at. Remove one you no longer need with delete_report.