Skip to main content
You can retrieve verification reports and associated data from iDenfy using two main methods: the Dashboard for bulk CSV reports, or the API for individual PDF reports and photos.

​
Dashboard Reports (CSV)

Generate comprehensive verification reports in CSV format directly from the iDenfy dashboard. These reports can cover multiple verifications within your chosen date range and include various data points.

​
API Retrieval (PDF and Photos)

Programmatically retrieve specific verification details using our API:
  1. PDF Reports: Download the full verification summary as a PDF using the PDF Generation endpoint. The report optionally includes the External Reference field — enable the checkbox in the Verification data section when generating the report from the dashboard.
  2. Verification Photos: Get URLs for specific user verification photos (document images, face photos) using the Data Retrieval endpoint.
Links to verification photos, whether obtained via API or webhook, are temporary and expire after 1 hour for security reasons. If you need long-term access, please download and store the photos locally soon after retrieval.

​
Bulk Downloading via API

To efficiently download multiple PDF reports or photos using the API:
  1. Get scanRef List: Generate a Verification Report on the Dashboard for your desired date range, ensuring the report includes the scanRef column. The scanRef is the unique identifier for each verification.
  2. Iterate with API: Create a script or application to loop through the list of scanRefs from the report. For each scanRef, call the appropriate API endpoint (PDF Generation or Data Retrieval) to download the corresponding file to your system.