GET
/
v1
/
upload
/
Perform bulk email validation
curl --request GET \
  --url https://bulk.debounce.io/v1/upload/
{
  "debounce": {
    "list_id": "8620",
    "list_name": "test-list"
  },
  "success": "1"
}
You can run only one list for validation at a time (validate your email lists one by one).
  • After upload, the list will automatically start validation.
  • If you already have a running list, your uploaded file will be queued for validation.
To use this API endpoint:
  • Upload the email list to your own server.
  • Provide the full URL of the list.
  • The URL must:
    • Start with https
    • End with .csv or .txt
Public file-sharing platforms such as Google Drive or Dropbox are not supported.
You must use your own server for file sharing.
File requirements:
  • Must be less than 20MB
  • Can contain a maximum of 200,000 emails
If successful, you will receive a response like this:

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