Enrich contacts with specific fields

POST

/lead-finder/enrich

Reveal specific contact fields (email and/or phone) for up to 25 leads.

Pricing:

Email: 50 credits per lead

Phone: 525 credits per lead

Previously revealed fields are returned from cache at no cost.

Async: Returns a jobId immediately (< 100ms). Poll GET /lead-finder/reveal-jobs/:jobId every 2 seconds until status is completed or failed. Credits are charged inside the worker — insufficient credits cause the job to fail asynchronously (no synchronous 402).

Requires approved Lead Finder access. Returns 403 if your team has not been approved.

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

Enrich job submitted — poll the returned jobId for results

Headers

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Payment Required

🟠429Too Many Requests

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://dev.enrich.so/api/v3/lead-finder/enrich' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "leads": [
        {
            "id": "string"
        }
    ],
    "fields": [
        "email"
    ]
}'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "jobId": "rj_a1b2c3d4e5f6g7h8",
        "status": "pending",
        "totalLeads": 3,
        "fields": [
            "email"
        ],
        "message": "Enrich job submitted. Poll GET /api/v3/lead-finder/reveal-jobs/rj_a1b2c3d4e5f6g7h8 for results."
    },
    "meta": {
        "requestId": "req_664f2b3c9a1e4d0012abcdf3"
    }
}

Modified at 2026-03-19 14:24:59

Reveal contact info

Unlock full last names