Find phone numbers in batch

POST

/reverse-lookup/phones/bulk

Submit up to 500 000 items (email addresses and/or profile URLs) for
bulk phone lookup. Emails are deduplicated case-insensitively; profile
URLs are deduplicated as-is.

Cost: 10 credits per unique item, reserved upfront. At settlement,
only items where phones were actually found are charged — the rest are
refunded.

Webhook callbacks

If you include a webhookUrl, your server will receive:

A per-result callback for every item as it is processed. See
phoneResult for the payload.

A completion callback when every item has been processed. See
phoneCompletion 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 job 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/phones/bulk' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "emails": [
        "sarah.chen@stripe.com",
        "james.rodriguez@hubspot.com"
    ],
    "linkedins": [
        "https://www.example.com/in/priyapatel"
    ],
    "webhookUrl": "https://api.yourapp.com/webhooks/enrich"
}'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "batchId": "665c52bf7b8e3f00149f0a10",
        "status": "queued",
        "itemCount": 3,
        "message": "Bulk phone lookup job created",
        "originalCount": 3,
        "duplicatesRemoved": 0
    },
    "meta": {
        "requestId": "665c52bf7b8e3f00149f0a0f",
        "creditsReserved": 1500,
        "creditsPerItem": 500,
        "estimatedCredits": 1500
    }
}

Modified at 2026-02-07 15:01:45

Find phone numbers

Check bulk phone lookup progress

Find phone numbers in batch

Webhook callbacks#

Request

Responses

Webhook callbacks