Documentation

Use the job_id returned from the bulk upload endpoint to retrieve validation progress and final results.

Endpoint

GET https://api.check365.io/api/validation/bulk-status?api_key=[YOUR_API_KEY]&job_id=[JOB_ID]

Request Parameters:

• job_id (string): The unique identifier for the bulk validation job.
• api_key (string): Your unique API key.

Example request

curl "https://api.check365.io/api/validation/bulk-status?api_key=YOUR_API_KEY&job_id=YOUR_JOB_ID"

Response:

• success (boolean): Indicates whether the request was successful.
• message (string): A message describing the result of the status check.
• data (object): An array of email addresses with their validation results.
• > jobId (string): The unique identifier of the bulk validation job.
• > status (string): The current job status (for example: completed).
• > creditsUsed (integer): The number of credits consumed by the bulk validation job.
• > progress (integer): The percentage of the bulk job completed.
• > total (integer): The total number of emails processed in the job.
• > results (array): An array containing the validation result for each email address.
• >> email (string): The email address that was validated.
• >> emailProvider (string): The email hosting provider associated with the email address (for example: microsoft365, google_workspace).
• >> emailType (string): The type of email address (e.g., personal, professional).
• >> status (string): The status of the email address (e.g., active, inactive, spam trap, invalid).
• >> isRole (boolean): Indicates whether the email address is a role-based email address.

Example response

{
  "success": true,
  "message": "Job has been completed",
  "data": {
    "jobId": "YOUR_JOB_ID",
    "status": "completed",
    "creditsUsed": 12,
    "progress": 100,
    "total": 2,
    "results": [
      {
        "email": "john@example.com",
        "emailProvider": "microsoft365",
        "emailType": "professional",
        "status": "active",
        "isRole": false
      }
    ]
  }
}