Find personal emails in batch

POST

/linkedin-to-personal-email/batch

Submit up to 500 000 LinkedIn profile URLs in one request. The batch runs in the background:
submit it, poll for status (or wait for the webhook), then fetch the results.

We deduplicate by profile, so the same person sent in different URL shapes is looked up and charged
once. Entries that are not LinkedIn profile URLs are skipped and counted in invalidCount.

Cost: 10 credits per distinct profile, reserved at submission. When the batch finishes you
are charged 10 per email found and the rest is refunded. Most profiles have no personal email on
file, so most of a reservation usually comes back. If your balance cannot cover the reservation you
get 402 and nothing is queued.

Webhook callback

If you include a webhookUrl, your server receives one completion callback when the whole batch
is done. See personalEmailCompletion for the
payload. There is no per-result callback for this product — fetch the results for the rows.

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

Batch queued and credits reserved

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠402Payment Required

🟠429Too Many Requests

🔴500Internal Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://dev.enrich.so/api/v3/linkedin-to-personal-email/batch' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "linkedinUrls": [
        "https://www.linkedin.com/in/jane-doe",
        "linkedin.com/in/Jane-Doe/",
        "https://www.linkedin.com/in/john-roe",
        "https://www.linkedin.com/in/aisha-johnson",
        "not a url"
    ],
    "webhookUrl": "https://api.yourapp.com/webhooks/enrich"
}'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "batchId": "6ac7959861a97a99319b48c4",
        "status": "queued",
        "itemCount": 3,
        "originalCount": 5,
        "duplicatesRemoved": 1,
        "invalidCount": 1
    },
    "meta": {
        "requestId": "a836f13a-b94e-47cf-98a0-0f8837db205f",
        "creditsReserved": 30,
        "creditsPerItem": 10,
        "estimatedCredits": 30
    }
}

Modified at 2026-10-08 14:22:25

Find a personal email by LinkedIn URL

Check personal email batch progress

Find personal emails in batch

Webhook callback#

Request

Responses

Webhook callback