Upload a batch file for email validation

curl --request POST \
  --url https://api.revenuebase.ai/v1/batch-upload \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-key: <api-key>' \
  --form 'requested_file=<string>'

{
  "process_id": 123,
  "filename": "<string>",
  "status": "<string>"
}

Email Verification

Upload a batch file for email validation

deprecated

⚠️ Deprecated — use POST /v2/email/verify/batch instead. Sunset: Tue, 07 Jul 2026.

Accepts a .csv or .json file and queues it for asynchronous processing. Returns a process_id — use it to poll status or download results when complete. Set metadata=true to include MX record, email provider, and failure reason fields in the output file.

Errors

400 invalid_extension — File must be .csv or .json.
400 upload_error — File upload failed. Contact support.

POST

batch-upload

Upload a batch file for email validation

curl --request POST \
  --url https://api.revenuebase.ai/v1/batch-upload \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-key: <api-key>' \
  --form 'requested_file=<string>'

{
  "process_id": 123,
  "filename": "<string>",
  "status": "<string>"
}

Authorizations

x-key

string

header

required

Query Parameters

metadata

boolean

default:false

Include detailed metadata in response

Body

multipart/form-data

requested_file

string

required

Response

Successful Response

process_id

integer

required

filename

string

required

status

string

required

Validate a single email address Queue a pre-uploaded batch file for processing

⌘I