Estimate Find Contact Data Job

POST

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

Estimate the credit cost for enriching contacts with email and phone data. Accepts either explicit contact_ids or a list_id to target an entire list. Returns the number of eligible contacts and the estimated total credits that would be consumed.
Credit Note: This endpoint does not consume credits.

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/estimate?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

🟢200OK

application/json

Estimate calculated successfully

Bodyapplication/json

Example

{
    "data": {
        "type": "find_contact_data_job_estimate",
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "attributes": {
            "estimated_total_credits": 2,
            "eligible_contacts": 2
        }
    },
    "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

Remove Contact from Lists

Create Find Contact Data Job