Skip to main content
GET
/
v1
/
status
Check bulk validation status
curl --request GET \
  --url 'https://bulk.debounce.io/v1/status/?api='
{
  "debounce": {
    "list_id": "20664",
    "status": "processing",
    "percentage": 39,
    "download_link": ""
  },
  "success": "1"
}
The validation status endpoint allows you to check the progress of a list previously uploaded through the bulk validation API. Once processing is complete, the response includes a link to download the results as a .csv file.

​
When to Use This Endpoint

  • After uploading a list via the bulk upload API
  • To monitor validation progress (queued, processing, completed)
  • To retrieve the final downloadable results file
This endpoint works only for lists uploaded through the bulk API.
Dashboard uploads do not return an API-accessible status.

Authorizations

​
api
string
query
required

API key for authentication

Query Parameters

​
list_id
string
required

The list ID returned from the upload request

Response

200 - application/json

Status retrieved successfully

​
success
enum<string>
required

Whether the status request was successful

Available options:
0,
1
​
debounce
object