Export leads to CSV (async)

POST

/lead-finder/export

Submit an async CSV export job. Returns a jobId immediately — poll GET /lead-finder/export-jobs/{jobId} for status. Once the job reaches completed status, download the file via GET /lead-finder/export-jobs/{jobId}/download.

Credits are estimated upfront and deducted during processing. Refunds are issued for leads where the requested contact info was not found.

Pricing:

Preview fields only: Free

includeEmail: 50 credits per lead

includePhone: 525 credits per lead

includeNames: 1 credit per lead (full last names)

includeContactInfo: Shorthand for email + phone (575 credits/lead)

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

Export job submitted — poll for status using the returned jobId

Headers

Body

🟠400Bad Request

🟠401Unauthorized

🟠402Payment Required

🟠403Too Many Requests

🟠429Internal Server Error

🔴500Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://dev.enrich.so/api/v3/lead-finder/export' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "filters": {
        "jobLevel": [
            "C-Suite",
            "VP"
        ],
        "domain": [
            "stripe.com",
            "vercel.com"
        ]
    },
    "maxResults": 500,
    "includeEmail": true,
    "includeNames": true
}'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "jobId": "ej_a1b2c3d4e5f6a7b8",
        "status": "pending",
        "estimatedRows": 500,
        "estimatedCredits": 25000,
        "message": "Export job queued. Poll GET /lead-finder/export-jobs/ej_a1b2c3d4e5f6a7b8 for status."
    },
    "meta": {
        "requestId": "665d2f8b9c5b2a0015d0bc0f"
    }
}

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

Search leads

Count matching leads