Reacher
  • Welcome to Reacher
  • Getting Started
    • Verify your 1st email
    • Understanding "is_reachable"
  • Self-Hosting
    • SaaS vs Self-Host
    • Install Reacher in 20min
    • Scaling for Production
      • Manage scaling yourself
      • Option 1: RabbitMQ-based Queue Architecture
    • Licensing
      • Commercial License Trial
    • Proxies
      • Multiple Proxies
    • Reacher Configuration
    • Debugging Reacher
  • Advanced
    • OpenAPI
      • /v0/check_email
      • /v1/check_email
      • /v1/bulk
    • Run your own Proxy
    • Migrations
      • Reacher Configuration (v0.10)
      • Migrating from 0.7 to 0.10
      • Bulk Verification (v0.7)
      • Docker Environment Variables (v0.7)
Powered by GitBook
On this page
  1. Advanced
  2. OpenAPI

/v1/bulk

Previous/v1/check_emailNextRun your own Proxy

Last updated 4 months ago

Retrieve bulk verification results

get

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
Path parameters
job_idstringRequired

The unique bulk verification job ID

Query parameters
limitintegerOptional

The number of results to return.

Default: 50
offsetintegerOptional

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

Responses
200
OK
application/json
get
GET /v1/bulk/{job_id}/results HTTP/1.1
Host: api.reacher.email
Authorization: YOUR_API_KEY
Accept: */*
200

OK

{
  "results": {
    "input": "name@gmail.com",
    "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"
        }
      }
    }
  }
}
  • POST/v1/bulk
  • GET/v1/bulk/{job_id}
  • GETRetrieve bulk verification results

/v1/bulk/{job_id}

get

Retrieve the progress of a bulk verification job.

Authorizations
Path parameters
job_idintegerRequired

The unique bulk verification job ID

Responses
200
OK
application/json
get
GET /v1/bulk/{job_id} HTTP/1.1
Host: api.reacher.email
Authorization: YOUR_API_KEY
Accept: */*
200

OK

{
  "job_id": 1,
  "created_at": "2025-05-12T22:38:11.496Z",
  "finished_at": "2025-05-12T22:38:11.496Z",
  "total_records": 1,
  "total_processed": 1,
  "summary": {
    "total_safe": 1,
    "total_invalid": 1,
    "total_risky": 1,
    "total_unknown": 1
  },
  "job_status": "Running"
}

/v1/bulk

post

Initiate a bulk email verification.

Authorizations
Body
inputstring[]Required

A list of emails to verify.

Responses
200
OK
application/json
post
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": {}
    }
  }
}
200

OK

{
  "job_id": 1
}