Get scan results by UUID
API Reference
Get scan results
Retrieve the stored DarkRecon result payload by scan UUID.
GET
Get scan results by UUID
Get scan results
Returns the full stored result payload for a previous scan.What comes back
- Top-level metadata such as
scan_id,status,total_breaches, andcreated_at. - The original
keywordsarray or the scanneddomain. - Optional
discovered_emailsfor domain-driven scans. - Optional
error_detailwhen the stored scan ended in an error state. - A
resultsobject keyed by breach database name.
Result parsing notes
- Each breach source object contains
InfoLeak,NumOfResults, andData. Datais an array of raw records from that source. Field names vary across breach databases.- Password-like values are masked in returned records.
total_breachescounts breach sources, not the total number of records across allDataarrays.
Error behavior
404: the suppliedscan_iddoes not exist.403: the API key could not be validated.422: request validation failed, such as a missingX-API-Keyheader or malformed path input.
Authorizations
API key for authentication. Create keys via the admin dashboard.
Path Parameters
The UUID returned from POST /scan
Response
Scan results
Stored scan result returned by GET /scan/{scan_id}.
The keywords that were scanned
Domain that was enumerated (if provided)
Number of breach databases found
Final stored scan status
Available options:
success, no_results, no_queries, error When the stored scan record was created
Emails discovered from domain enumeration
Error message if scan failed
Raw breach data keyed by database name. Each entry contains InfoLeak (description), NumOfResults (count), and Data (array of breach records). Passwords are masked.
