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 validation status returned for the email address.
• >> safeToSend (boolean): Indicates whether the email is considered safe for sending campaigns.
• >> risk (string): Risk level for the email address (for example: low, medium, high).
• >> isRole (boolean): Indicates whether the email address is a role-based email address.
• >> statusReason (string): A machine-readable reason for the returned status.

Example response

{
  "success": true,
  "message": "Job has been completed",
  "data": {
    "jobId": "YOUR_JOB_ID",
    "status": "completed",
    "creditsUsed": 12,
    "progress": 100,
    "total": 2,
    "results": [
      {
        "email": "name@company.com",
        "emailProvider": "unknown",
        "emailType": "unknown",
        "status": "unvalidated",
        "safeToSend": false,
        "risk": "high",
        "isRole": false,
        "statusReason": "invalid_domain"
      }
    ]
  }
}