Phone Finder: per-result callback

Webhook

POST

phoneResult

Your server receives this POST once for every item (email or profile URL)
in a bulk phone lookup job. The phones array contains the numbers found, or
error will have a message if the lookup failed.

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

Return any 2xx to acknowledge receipt

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://your-api-server.com' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "event": "webhook:phone_result.completed",
    "timestamp": "2025-06-03T14:35:00.000Z",
    "data": {
        "job_id": "665c52bf7b8e3f00149f0a10",
        "result_id": "sarah.chen@stripe.com",
        "type": "success",
        "phones": [
            "+14158009370"
        ],
        "message": "Phone numbers found"
    }
}'

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

Email Finder: batch completion callback

Phone Finder: batch completion callback