Look up professional profiles in batch

POST

/reverse-lookup/bulk-lookup

Submit up to 100 000 emails and get back professional profile data for each
one. Duplicate emails are removed (case-insensitive) before processing.

Cost: 10 credits per unique email, reserved upfront. Credits for emails
where no profile was found are refunded.

Webhook callbacks

If you include a webhookUrl, your server will receive:

A per-result callback for every email as it is processed. See
reverseLookupResult for the payload.

A completion callback when the entire batch finishes. See
reverseLookupCompletion for the payload.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Bulk lookup submitted — credits have been reserved

Body

🟠400Bad Request

🟠401Unauthorized

🟠402Payment Required

🟠429Too Many Requests

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://dev.enrich.so/api/v3/reverse-lookup/bulk-lookup' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "emails": [
        "emily.zhang@figma.com",
        "david.kim@vercel.com",
        "aisha.johnson@cloudflare.com"
    ],
    "webhookUrl": "https://api.yourapp.com/webhooks/enrich"
}'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "batchId": "665d2f8b9c5b2a0015d0bc10",
        "status": "queued",
        "itemCount": 3,
        "message": "Bulk lookup job created",
        "originalCount": 3,
        "duplicatesRemoved": 0
    },
    "meta": {
        "requestId": "665d2f8b9c5b2a0015d0bc0f",
        "creditsReserved": 30,
        "creditsPerItem": 10,
        "estimatedCredits": 30
    }
}

Modified at 2026-03-03 16:55:18

Get bulk phone lookup results

Look up a professional profile by email

Look up professional profiles in batch

Webhook callbacks#

Request

Responses

Webhook callbacks