Skip to main content
POST
/
phone
/
bulk
curl --request POST \
  --url https://api.enrow.io/phone/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "linkedin_url": "https://www.linkedin.com/in/michael-scott"
      },
      {
        "linkedin_url": "https://www.linkedin.com/in/dwight-schrute"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow/phone"
    }
  }'

{
  "credits_used": 80,
  "estimated_duration": 1,
  "id": "e3b61122-d6a6-4ea7-b331-9b734682a76a",
  "message": "Bulk search operating",
  "credits": {
    "amount": 80,
    "source": "sub",
    "split": {
      "fromPaygo": 0,
      "fromSub": 80
    }
  }
}
POST 
https://api.enrow.io/phone/bulk
Run multiple phone searches in a single request. Up to 3,000 searches per batch. Authenticate every request with your API key in the x-api-key header. To find a single phone number, use the Find Single Phone endpoint. Each search needs to contain either:
  • The URL of a person’s LinkedIn profile (e.g., https://www.linkedin.com/in/michael-scott/)
  • The combination of individual information: firstname + lastname + (company_name or company_domain)
The LinkedIn URL will always prevail on the individual information if both are present.

​
Request Body

​
searches
array of objects
required
Search payloads for which to find corresponding phone numbers.
​
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 created

​
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)
​
credits
object
Credit breakdown

​
Error Responses

CodeMessage
400At least 1 phone search must be present in the payload
400Missing payload
400Too many searches. Limit is currently at 3000 per batch.
401This apikey is not valid
401This account is not allowed to use the phone search feature
402Insufficient credits
When credits are insufficient, 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/phone/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "linkedin_url": "https://www.linkedin.com/in/michael-scott"
      },
      {
        "linkedin_url": "https://www.linkedin.com/in/dwight-schrute"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow/phone"
    }
  }'

{
  "credits_used": 80,
  "estimated_duration": 1,
  "id": "e3b61122-d6a6-4ea7-b331-9b734682a76a",
  "message": "Bulk search operating",
  "credits": {
    "amount": 80,
    "source": "sub",
    "split": {
      "fromPaygo": 0,
      "fromSub": 80
    }
  }
}

​
Next steps

Get bulk results

Retrieve the found phone numbers using the batch id.

Find a single phone

Run a single phone search from a LinkedIn URL or name and company.

Webhooks

Get notified automatically when a bulk search completes.

Credits & billing

See how credits are consumed for each endpoint.