Skip to main content
GET
Check bulk validation status
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