/v1/bulk

v1/bulk

posthttps://api.reacher.email/v1/bulk

Initiate a bulk email verification.

Authorizations

Authorization string required

A Reacher API key is required for all requests. Sign up on https://app.no2bounce.com/ to get your personal API key.

Body

input string[] required

A list of emails to verify.

webhook object · TaskWebhook optional Optional webhook configuration for sending email verification results during bulk verification.

Response object job_idinteger integer required

The unique ID generated for this bulk verification job. Use this job_id to query the progress or results of the bulk verification.

/v1/bulk

POST /v1/bulk HTTP/1.1
Host: api.reacher.email
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 72

{
  "input": [
    "text"
  ],
  "webhook": {
    "on_each_email": {
      "url": "text",
      "extra": {}
    }
  }
}

Response

{
  "job_id": 1
}

/v1/bulk/{job_id}

GET https://api.reacher.email /v1/bulk/ {job_id}

Retrieve the progress of a bulk verification job.

Authorizations Authorization string required

A Reacher API key is required for all requests. Sign up on https://app.no2bounce.com/ to get your personal API key.

Path parameters job_id integer required

The unique bulk verification job ID

/v1/bulk/{job_id}

GET /v1/bulk/{job_id} HTTP/1.1
Host: api.reacher.email
Authorization: YOUR_API_KEY
Accept: */*

Response

{
  "job_id": 1,
  "created_at": "2026-02-09T09:59:31.623Z",
  "finished_at": "2026-02-09T09:59:31.623Z",
  "total_records": 1,
  "total_processed": 1,
  "summary": {
    "total_safe": 1,
    "total_invalid": 1,
    "total_risky": 1,
    "total_unknown": 1
  },
  "job_status": "Running"
}

Retrieve bulk verification results

GET https://api.reacher.email/v1/bulk/{job_id}/results

Retrieve the results of a bulk verification job. This endpoint will return an error if the job is still running. Please query GET /v1/bulk/{job_id} first to check the job's progress.

Authorizations Authorization string required

A Reacher API key is required for all requests. Sign up on https://app.no2bounce.com/ to get your personal API key.

Path parameters job_id string required

The unique bulk verification job ID

Query parameters limit integer optional

The number of results to return.

Default: 50 offset integer optional

The offset from which to return the results, equivalent to the number of elements in the array to skip.

/v1/bulk/{job_id}/results

GET /v1/bulk/{job_id}/results HTTP/1.1
Host: api.reacher.email
Authorization: YOUR_API_KEY
Accept: */*

Response

{
  "results": {
    "input": "[email protected]",
    "is_reachable": "invalid",
    "misc": {
      "is_disposable": true,
      "is_role_account": true,
      "gravatar_url": "text",
      "is_b2c": true
    },
    "mx": {
      "accepts_mail": true,
      "records": [
        "text"
      ]
    },
    "smtp": {
      "can_connect_smtp": true,
      "has_full_inbox": true,
      "is_catch_all": true,
      "is_deliverable": true,
      "is_disabled": true
    },
    "syntax": {
      "domain": "text",
      "is_valid_syntax": true,
      "username": "text"
    },
    "debug": {
      "start_time": "text",
      "end_time": "text",
      "duration": {
        "secs": 1,
        "nanos": 1
      },
      "server_name": "text",
      "smtp": {
        "verif_method": {
          "type": "Smtp"
        }
      }
    }
  }
}