Check very large lists

For lists too big for a single call (up to a million addresses), use jobs. A job runs in the background, so you do not have to wait on one long request. It works in three steps.

1. Create the job

Send your addresses (or a link to a CSV file). We analyse the list and tell you how many addresses will be checked. Creating a job is free — nothing is charged yet.

curl https://www.cleanmylist.io/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My list", "addresses": ["a@example.com", "b@example.com"]}'

2. Start the job

When you are happy with the estimate, start the job. This is when credits are used (1 per address).

curl -X POST https://www.cleanmylist.io/v1/jobs/JOB_ID/start \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Get the results

Once the job finishes, download the results as a CSV or as JSON.

curl https://www.cleanmylist.io/v1/jobs/JOB_ID/results?format=csv \
  -H "Authorization: Bearer YOUR_API_KEY"