API REFERENCE

Results & Download

Once a job finishes, fetch structured results as JSON, or download a CSV. Both require a JWT session. Download works even on partial/processing/failed jobs (it returns rows verified so far, with a -partial filename suffix).

Requires a dashboard session

Fetching results and downloading CSV use a JWT session (logged-in dashboard), not an API key.

GET/verification/results/{job_id}

Fetch JSON results for a completed job.

Fetch results

curl https://api.bouncecheck.email/api/v1/verification/results/42 \
  -H "Authorization: Bearer YOUR_JWT"

{
  "results": [
    {
      "email": "[email protected]",
      "is_valid": true,
      "is_disposable": false,
      "is_role_based": false,
      "mx_records": [],
      "smtp_check": true,
      "score": 100.0,
      "reason": "Address is deliverable"
    }
  ]
}

Download CSV

GET/verification/download/{job_id}

Download verification results as CSV.

Download CSV

curl https://api.bouncecheck.email/api/v1/verification/download/42 \
  -H "Authorization: Bearer YOUR_JWT" -o results.csv