Documentation

Developer documentation for Check365 APIs, SDKs, wrappers, and integrations.

Api Reference

Bulk Upload


The Bulk Email Validation endpoint can handle a lot of requests at once. It helps you clean up big email lists by putting addresses into one of four groups: Active, Inactive, Catch-All/Spam-All, or Unknown.

This endpoint runs in a disconnected (asynchronous) manner. It starts a validation task and gives you a unique Job ID that you can use to keep track of progress and get results when the processing is done.

Endpoint

POST https://api.check365.io/api/validation/bulk-upload

Example request

curl -X POST "https://api.check365.io/api/validation/bulk-upload" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": ["john@example.com", "mary@example.com"],
    "api_key": "YOUR_API_KEY",
    "job_id": "YOUR_JOB_ID"
  }'

Request Body:

  • emails (array): An array of email addresses to be validated.
  • api_key (string): Your unique API key.
  • job_id (string): A unique identifier for the bulk validation job. This ID will be used to check the status of the job.
{
  "emails": ["john@example.com", "mary@example.com"],
  "api_key": "YOUR_API_KEY",
  "job_id": "YOUR_JOB_ID"
}

Response:

  • success (string): Indicates whether the bulk validation was successful.
  • message (string): A message describing the result of the bulk submission.
  • job_id (string): The unique identifier for the bulk validation job. Use this ID to check the status of the job.

Example response

{
  "success": true,
  "message": "Emails have been sent for validation.",
  "job_id": "YOUR_JOB_ID"
}

Why Should You Use Bulk Validation?

It takes too long to check thousands of emails by hand. Check365 gives developers tools to check a lot of emails at once, thus our infrastructure takes care of the hard work of monitoring SMTP and MX records in the background.

  • Scale your cleaning: Work with thousands of leads at once.
  • Protect the sender's reputation: Finding a lot of unused or spam-trap emails keeps your domain from being blacklisted.
  • Asynchronous Workflow: Send in your list and move on. When you're ready, just poll the status endpoint with your job_id.