Skip to main content
POST
/
email
/
find
/
bulk
curl --request POST \
  --url https://api.enrow.io/email/find/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "fullname": "Dwight Schrute",
        "company_domain": "dundermifflin.com",
        "custom": "lead_001"
      },
      {
        "fullname": "Jim Halpert",
        "company_domain": "dundermifflin.com",
        "custom": "lead_002"
      },
      {
        "fullname": "Ryan Howard",
        "company_domain": "dundermifflin.com",
        "custom": "lead_003"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow",
      "retrieve_gender": true
    }
  }'

{
  "message": "Bulk search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 3,
  "estimated_duration": 1
}
POST 
https://api.enrow.io/email/find/bulk
Run multiple email searches in a single request. Up to 5,000 searches per batch. Authenticate every request with your API key in the x-api-key header. To find a single email instead, use the Find Single Email endpoint.
Enrow performs determinist verifications that verify even catch-all emails. No debouncer needed.

​
Request Body

​
searches
array of objects
required
Search payloads for which to find corresponding emails.
​
custom
object
Custom params that will be returned in the GET response and in the webhook notification.
​
settings
object
Settings relative to the whole bulk search.

​
Response

​
201 — Bulk search started

​
message
string
Confirmation message
​
id
string
Unique identifier for this batch. Use this to retrieve results via the GET endpoint.
​
credits_used
number
Total credits consumed. See Credits & billing for per-endpoint costs.
​
estimated_duration
number
Estimated processing time in minutes (not guaranteed)

​
Error Responses

CodeMessage
400Missing payload
400Missing searches payload
400Too many searches. Limit is currently at 5000 per batch.
400Error while parsing payload
401No apikey found in the x-api-key headers
401This apikey is not valid
402Insufficient credits
On insufficient credits, the bulk endpoint returns HTTP 402 with a body of the form { "message": "..." }. See Error handling for the full list of status codes and response formats.
curl --request POST \
  --url https://api.enrow.io/email/find/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "fullname": "Dwight Schrute",
        "company_domain": "dundermifflin.com",
        "custom": "lead_001"
      },
      {
        "fullname": "Jim Halpert",
        "company_domain": "dundermifflin.com",
        "custom": "lead_002"
      },
      {
        "fullname": "Ryan Howard",
        "company_domain": "dundermifflin.com",
        "custom": "lead_003"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow",
      "retrieve_gender": true
    }
  }'

{
  "message": "Bulk search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 3,
  "estimated_duration": 1
}

​
Next steps

Get bulk results

Retrieve the found emails using the batch id.

Find a single email

Run a single email search from a name and company.

Webhooks

Get notified automatically when a batch completes.

Credits & billing

See how credits are consumed for each endpoint.