API REFERENCE

Bulk Upload

Upload a CSV or XLSX file (max 10 MB) with an email column. Processing runs asynchronously; poll Job Status until the job completes, then fetch Results & Download.

Requires a dashboard session

Bulk upload uses a JWT session (logged-in dashboard), not an API key. Upload files from your dashboard or a session authenticated with a Bearer token.

POST/verification/bulk

Upload CSV/XLSX for batch verification (multipart/form-data, field name: file).

Upload

curl -X POST https://api.bouncecheck.email/api/v1/verification/bulk \
  -H "Authorization: Bearer YOUR_JWT" \
  -F "[email protected]"

Response

{
  "job_id": 42,
  "message": "File uploaded successfully. Processing 1000 emails.",
  "total_emails": 1000
}

The file must contain a column named email. Allowed types: CSV, XLSX, XLS. Your remaining monthly quota must cover the whole file.