---
title: "Download verification results"
method: GET
path: "/v1/verify/file/{job_id}/results"
tags: ["File Processing"]
---

# Download verification results

`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`

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).

## Path parameters

- `job_id` string, uuid, required

## Query parameters

- `valid` boolean
- `invalid` boolean
- `catchall` boolean
- `role` boolean
- `unknown` boolean
- `disposable` boolean
- `risky` boolean

## Response `200`

CSV file with filtered results

## Other responses

- `307`: Redirect to full result file (when no filters applied)
- `401`: Unauthorized - invalid or missing API key
- `404`: Resource not found

---

[API](https://skmtc.dev/billionverify/apis/billionverify-api.md) · [All operations](https://skmtc.dev/billionverify/apis/billionverify-api/llms.txt) · [OpenAPI document](https://skmtc.dev/billionverify/apis/billionverify-api/revisions/00762347dc27?raw)