# Verify Bulk Emails Source: https://docs.deliverable.co/api-reference/endpoint/verify-bulk POST /verify/bulk Upload a CSV file for bulk email verification. The file must have a header row. If you omit `emailColumn`, the API looks for a column named `Email`. Pass `emailColumn` if your header is something else (for example `Work Email` or `email`). Returns a `file_id` to track the processing status via `/verify/bulk/status`. Consumes credits based on the number of emails in the file. Max file size is 25MB. # Get All Bulk Files Source: https://docs.deliverable.co/api-reference/endpoint/verify-bulk-files GET /verify/bulk/files Returns a paginated list of all bulk verification files submitted under the authenticated API key. Supports pagination and optional search. # Get Bulk File Status Source: https://docs.deliverable.co/api-reference/endpoint/verify-bulk-status POST /verify/bulk/status Returns the processing status of a bulk verification file using its `file_id`. If processing is complete, a signed download URL for the results CSV is also returned. The URL expires after 1 hour. # Verify Single Email Source: https://docs.deliverable.co/api-reference/endpoint/verify-single POST /verify/single Submits an email for verification. Returns a task ID to check the verification status via the `/verify/single/status` endpoint. Consumes credits. Requires a valid API key and active subscription. # Get Single Email Status Source: https://docs.deliverable.co/api-reference/endpoint/verify-single-status POST /verify/single/status Returns the verification status for a task created by the `/verify/single` endpoint. The result will either be `pending` (still processing) or `completed` (with full verification result). # Introduction Source: https://docs.deliverable.co/api-reference/introduction Overview of the email verification and task status API ## Overview This API supports email verification and task status checks. Submit an email for verification and use the returned task ID to poll for results. ## Creating an API key Create and manage your API keys in the Deliverable dashboard: 1. Go to [**API keys**](https://app.deliverable.co/app/api). 2. Sign in or create an account if needed. 3. Create a new API key. Copy and store it securely; it is shown only once. Use this key in the `x-api-key` header for all API requests. ## Base URL Use the base URL for your environment (for example, `https://api.deliverable.co` for production). Check the API documentation or your dashboard for the exact URL. ## Authentication Send your API key in the `x-api-key` header with every request: ```json theme={null} "security": [ { "apiKeyAuth": [] } ] ``` ### Requirements * **Valid API key** — Keys are created at [app.deliverable.co/app/api](https://app.deliverable.co/app/api). Invalid or missing keys return `401 Unauthorized`. * **Active subscription** — Your account must have an active, paid subscription. Expired plans, failed payments, or accounts that require payment return `402 Payment Required`. Renew or update your subscription in the dashboard to restore access. # Changelog Source: https://docs.deliverable.co/changelog Product updates and API changes for Deliverable ## Bulk Verify API now accepts an optional `emailColumn` field You can now tell Deliverable which CSV column holds the emails. If you don't send `emailColumn`, the API still looks for a column named `Email`. ### What's changing * `emailColumn` is optional. Omit it and we look for a column named `Email`. * Send `emailColumn` if your header is something else, for example `Work Email` or `email`. * The file must have a real header row. A bare list of addresses with no header will be rejected. * `emailColumn` must be a column name, not an email address. ### Example request ```http theme={null} POST /verify/bulk Content-Type: multipart/form-data file: your-list.csv fileName: Q3 outreach emailColumn: Work Email mode: catch_all ``` ### Valid file ```csv theme={null} Work Email,Name alex@acme.com,Alex ``` ### Rejected file (no header) ```csv theme={null} alex@acme.com sam@acme.com ``` If the header is missing, the API returns: ``` Email column header is missing from the file ``` ### What you need to do 1. Add a header row to every bulk CSV. 2. If the column is named `Email`, you don't need to change anything. 3. If it isn't, pass that header as `emailColumn`. The website bulk upload is unchanged. Single email verification (`POST /verify/single`) is unchanged.