Skip to main content
GET
/
phone
/
bulk
curl --request GET \
  --url 'https://api.enrow.io/phone/bulk?id=e3b61122-d6a6-4ea7-b331-9b734682a76a' \
  --header 'x-api-key: YOUR_API_KEY'

{
  "general": {
    "id": "e3b61122-d6a6-4ea7-b331-9b734682a76a",
    "status": "completed"
  },
  "results": [
    {
      "country": "US",
      "index": 0,
      "number": "+15705551234",
      "params": {
        "linkedin_url": "https://www.linkedin.com/in/michael-scott"
      },
      "qualification": "found"
    },
    {
      "country": "US",
      "index": 1,
      "number": "+15705555678",
      "params": {
        "linkedin_url": "https://www.linkedin.com/in/dwight-schrute"
      },
      "qualification": "found"
    }
  ],
  "stats": {
    "credits_cost": 80,
    "credits_to_refund": 0,
    "found": 2,
    "requested": 2
  }
}
GET 
https://api.enrow.io/phone/bulk?id={batch_id}
Retrieve results of a previously submitted bulk phone search. Authenticate every request with your API key in the x-api-key header.
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 finished

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

​
200 — Search ongoing

​
general
object
id and status: "ongoing"
​
stats
object
requested and finished counts

​
Error Responses

CodeMessage
400Missing id in the query params
400Could not retrieve bulk search results
500server error
See Error handling for the full list of status codes and response formats. 
curl --request GET \
  --url 'https://api.enrow.io/phone/bulk?id=e3b61122-d6a6-4ea7-b331-9b734682a76a' \
  --header 'x-api-key: YOUR_API_KEY'

{
  "general": {
    "id": "e3b61122-d6a6-4ea7-b331-9b734682a76a",
    "status": "completed"
  },
  "results": [
    {
      "country": "US",
      "index": 0,
      "number": "+15705551234",
      "params": {
        "linkedin_url": "https://www.linkedin.com/in/michael-scott"
      },
      "qualification": "found"
    },
    {
      "country": "US",
      "index": 1,
      "number": "+15705555678",
      "params": {
        "linkedin_url": "https://www.linkedin.com/in/dwight-schrute"
      },
      "qualification": "found"
    }
  ],
  "stats": {
    "credits_cost": 80,
    "credits_to_refund": 0,
    "found": 2,
    "requested": 2
  }
}

​
Next steps

Find phones in bulk

Submit a new batch of phone number searches.

Get a single result

Retrieve the result of a single phone search by id.

Webhooks

Get notified automatically when a batch completes.

Credits & billing

See how credits are consumed and refunded.