Reveal contact info

POST

/lead-finder/reveal

Reveal contact info for up to 25 leads. Choose which fields to reveal via the optional fields parameter:

["email"] — 50 credits per lead

["phone"] — 525 credits per lead

["email", "phone"] — 575 credits per lead (default if omitted)

Previously revealed contacts 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

Reveal 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/reveal' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "leads": [
        {
            "id": "enc_abc123def456"
        }
    ],
    "fields": [
        "email"
    ]
}'

Response Example

200 - Success

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

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

Count matching leads

Enrich contacts with specific fields