Skip to main content
GET
/
v1
/
upload
Perform bulk email validation
curl --request GET \
  --url 'https://bulk.debounce.io/v1/upload/?api='
{
  "debounce": {
    "list_id": "8620",
    "list_name": "test-list"
  },
  "success": "1"
}
The bulk upload endpoint allows you to validate large email lists.
Only one bulk validation job can run at a time per account.
  • After uploading a file, validation starts automatically.
  • If a job is already running, any new upload will be queued and processed afterward.

​
File Hosting Requirements

To use this endpoint, you must:
  • Upload the file to your own server
  • Provide the public HTTPS URL to the file
  • Ensure the URL ends with .csv or .txt
Public file-sharing services (Google Drive, Dropbox, OneDrive, etc.) are not supported.
Only direct-file URLs hosted on your own server can be processed.

​
File Requirements

Your uploaded file must meet these conditions:
  • File size less than 20MB
  • Maximum 200,000 emails per list
  • File type: .csv or .txt
  • One email per line
If your list exceeds the limit, split it into multiple files and upload them one by one.

Authorizations

​
api
string
query
required

API key for authentication

Query Parameters

​
api
string
required

Your DeBounce API key

​
url
string<uri>
required

URL of your .csv or .txt email list, starting with https and uploaded in your server.

Response

Bulk upload accepted and processing started

​
success
enum<string>
required

Whether the upload was successful

Available options:
0,
1
​
debounce
object