File Processing

Download verification results

Download the verification results for a completed job.

Without filters: Returns redirect (HTTP 307) to the full result file.

With filters: Returns a CSV containing only matching emails.

Multiple filters can be combined (OR logic).

get/v1/verify/file/{job_id}/results

Request

  • Base URL: https://api.billionverify.com
  • URL: https://api.billionverify.com/v1/verify/file/{job_id}/results
  • Auth: API key in header BV-API-KEY

Path parameters

job_idstring uuid required

The job ID

Query parameters

validboolean

Include valid emails

invalidboolean

Include invalid emails

catchallboolean

Include catch-all emails

roleboolean

Include role emails

unknownboolean

Include unknown emails

disposableboolean

Include disposable emails

riskyboolean

Include risky emails (deliverable, but the domain has a confirmed abuse history — see risk_reasons). Most list-cleaning exports should leave this off, the same way they leave disposable off.

Response

CSV file with filtered results

Changes

No recorded changes to this operation across all 1 revision of this API.