How do I export my ZapBounce verification results?

When a job finishes, call GET /v1/jobs/{id}/export and you get one CSV with a row per address. Save it next to your own file and match on the email column. The bulk verification page shows the upload side of the same flow.

Here's what the columns hold. status is one of four values: valid, invalid, catch_all or unknown. reason_code says why, for example MAILBOX_NOT_FOUND or TEMPORARY_FAILURE. mx is the mail host that answered, smtp_code is the server's literal reply so you can audit the reading, and checked_at records when. The result codes reference lists every reason.

For a filtered export, sort or filter on status in your spreadsheet. Most teams keep valid, delete invalid, and move catch_all and unknown rows into their own tab. Unknown rows are refunded, so it's worth re-running them in a week, once greylisting or throttling has cleared.

From code, you have two routes. Poll the batch status call until the job status is completed, then fetch the CSV. To read rows into a database while the job is still running, page through GET /v1/jobs/{id}/emails?page=1&pageSize=100, which also takes status and q filters.

Download what you need, and delete the job when you are done with it. DELETE /v1/jobs/{id} removes a job and its addresses at once. The bulk verification docs show the full jobs flow.

Can I download verification results as Excel?

The API export is a CSV, which Excel opens directly. Open it and save it as XLSX if your team prefers that format.

Does the export keep my original columns?

The export holds the email, status, reason_code, mx, smtp_code and checked_at columns. Match it to your own file on the email column to keep your other fields.

How long can I download results after a job finishes?

Results stay available through GET /v1/jobs/{id}/export until you delete the job with DELETE /v1/jobs/{id}.

Can I export only the valid emails?

Call GET /v1/jobs/{id}/emails?status=valid to page through only the valid rows, or filter the CSV on the status column. The full export keeps every row, so you can revisit catch_all and unknown rows later.

Check this against your own list

100 free credits a month, no card. Unknown results come back labeled and are never billed.