Create Find Contact Data Job

POST

/v1/contacts/find-contact-data-jobs

Trigger an asynchronous job to enrich the given contacts with email and phone data. Accepts either explicit contact_ids or a list_id to target an entire list. The job runs in the background; poll the status endpoint to check progress.
Credit Note: Credits are consumed as contacts are enriched.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Body Params application/jsonRequired

Examples

Target specific contactsTarget an entire list

{
    "data": {
        "type": "find_contact_data_job",
        "attributes": {
            "contact_ids": [
                "1515122",
                "90571874"
            ]
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Target specific contactsTarget an entire list

curl --location 'https://api.leadfeeder.com/v1/contacts/find-contact-data-jobs?account_id=123456' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "type": "find_contact_data_job",
        "attributes": {
            "contact_ids": [
                "1515122",
                "90571874"
            ]
        }
    }
}'

Responses

🟢202Accepted

application/json

Job accepted and started

Bodyapplication/json

Example

{
    "data": {
        "type": "find_contact_data_job",
        "id": "job_550e8400",
        "attributes": {
            "status": "running",
            "created_at": "2026-03-10T12:00:00Z"
        }
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

🟠429Server Error

🔴500Server Error

Modified at 2026-06-10 13:11:29

Estimate Find Contact Data Job

Get Find Contact Data Job Status