Skip to main content

​
Authentication

​
x-api-key
string
required
Your API key

​
Body

​
emails
string[]
required
List of email addresses to search.
  • Minimum: 1 email
  • Maximum: 5000 emails
  • Invalid emails are automatically filtered out
Example: ["[email protected]", "[email protected]"]
​
custom
any
Custom data to associate with this bulk search. Will be returned in the webhook if configured.
​
settings
object
Optional search configuration.
curl -X POST https://api.reverselooker.com/reverse-contact/bulk \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -d '{
    "emails": [
      "[email protected]",
      "[email protected]",
      "[email protected]"
    ]
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "number_of_searches": 3,
  "credits_used": 150,
  "message": "Bulk reverse contact search operating"
}

​
Response

​
id
string
required
Unique bulk search identifier. Use it with GET /reverse-contact/bulk to retrieve results.
​
number_of_searches
number
required
Number of valid emails that will be searched (after filtering invalid emails).
​
credits_used
number
required
Total credits consumed (50 × number of emails).
​
message
string
required
Confirmation message.

​
Email validation

Emails are validated before processing:
  • Invalid emails are automatically excluded
  • Emails are normalized to lowercase
  • If no valid emails remain after filtering, a 400 error is returned
For large volumes, split your requests into batches of 5000 emails maximum.

​
Next step

Retrieve results

Use the returned ID to track progress and get the found profiles.