Skip to main content
GET
/
email
/
find
/
bulk
curl --request GET \
  --url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
  --header 'x-api-key: YOUR_API_KEY'

{
  "general": {
    "id": "3d4cb64e-i64d-41e8-a686-736751004a32",
    "status": "completed",
    "custom": "campaign_q2"
  },
  "stats": {
    "finished": 3,
    "requested": 3,
    "valid": 2,
    "credits_cost": {
      "initial": 3,
      "refunded": 1,
      "final": 2
    }
  },
  "results": [
    {
      "index": "0",
      "qualification": "valid",
      "email": "dwight.schrute@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Dwight",
        "lastname": "Schrute",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Dwight Schrute"
      },
      "custom": "lead_001"
    },
    {
      "index": "1",
      "qualification": "valid",
      "email": "jim.halpert@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Jim",
        "lastname": "Halpert",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Jim Halpert"
      },
      "custom": "lead_002"
    },
    {
      "index": "2",
      "qualification": "invalid",
      "email": null,
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Ryan Howard"
      },
      "custom": "lead_003"
    }
  ]
}
GET 
https://api.enrow.io/email/find/bulk?id={id}
Retrieve all results from a batch email search using the batch ID. Authenticate every request with your API key in the x-api-key header. The batch ID is the id returned when you start a job with the Find Bulk Emails endpoint.
Using a webhook allows you to skip calling this GET endpoint. See How Webhooks Work.

​
Query Parameters

​
id
string
required
The id returned from the POST request

​
Response

​
200 — Search completed

​
general
object
Batch metadata
​
stats
object
Batch statistics
​
results
array
Array of search results

​
200 — Search still in progress

While the batch is running, the GET endpoint returns HTTP 200 with a reduced body of the shape { general: { id, status: "ongoing" }, stats: { finished, requested } }.
​
general
object
id and status: "ongoing"
​
stats
object
finished and requested counts

​
Error Responses

CodeMessage
400Could not retrieve bulk search results
See Error handling for the full list of status codes and response formats. 
curl --request GET \
  --url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
  --header 'x-api-key: YOUR_API_KEY'

{
  "general": {
    "id": "3d4cb64e-i64d-41e8-a686-736751004a32",
    "status": "completed",
    "custom": "campaign_q2"
  },
  "stats": {
    "finished": 3,
    "requested": 3,
    "valid": 2,
    "credits_cost": {
      "initial": 3,
      "refunded": 1,
      "final": 2
    }
  },
  "results": [
    {
      "index": "0",
      "qualification": "valid",
      "email": "dwight.schrute@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Dwight",
        "lastname": "Schrute",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Dwight Schrute"
      },
      "custom": "lead_001"
    },
    {
      "index": "1",
      "qualification": "valid",
      "email": "jim.halpert@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Jim",
        "lastname": "Halpert",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Jim Halpert"
      },
      "custom": "lead_002"
    },
    {
      "index": "2",
      "qualification": "invalid",
      "email": null,
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Ryan Howard"
      },
      "custom": "lead_003"
    }
  ]
}

​
Next steps

Find emails in bulk

Start a new batch of up to 5,000 email searches.

Webhooks

Skip polling and get notified when a batch completes.

Credits & billing

See how credits are charged and refunded per result.

Verify emails in bulk

Validate a list of email addresses in a single batch.