Get Find Contact Data Job Status

GET

/v1/contacts/find-contact-data-jobs/{job_id}

Retrieve the current status of a Find Contact Data job. Returns progress counters, credit consumption, and any errors.
Jobs are retained for 7 days after completion.
Credit Note: This endpoint does not consume credits.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

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

Path Params

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.leadfeeder.com/v1/contacts/find-contact-data-jobs/job_550e8400?account_id=123456' \
--header 'X-Api-Key: <api-key>'

Responses

🟢200OK

application/json

Job status retrieved

Bodyapplication/json

Examples

Completed jobFailed job

{
    "data": {
        "type": "find_contact_data_job",
        "id": "job_550e8400",
        "attributes": {
            "status": "completed",
            "configuration": {
                "contact_ids": [
                    "1515122",
                    "90571874"
                ]
            },
            "credits": {
                "estimated": 2,
                "consumed": 2
            },
            "summary": {
                "total": 2,
                "succeeded": 2,
                "failed": 0
            },
            "created_at": "2026-03-10T12:00:00Z",
            "completed_at": "2026-03-10T12:01:42Z"
        }
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠403Forbidden

🟠404Record Not Found

🟠429

🔴500Server Error

Modified at 2026-05-18 11:47:40

Create Find Contact Data Job

How to Create Custom Feed