LEleadfeeder
Contacts
Enrichment
v1

Get Find Contact Data Job Status

Changed on

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.

:::info Requires the contacts:read OAuth2 scope. :::

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

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/contacts/find-contact-data-jobs/{job_id}
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
      Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: contacts:read

Path parameters

job_idstring required

The unique identifier of the enrichment job

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

Response

Job status retrieved

Example response

{
  "data": {
    "attributes": {
      "completed_at": "2026-03-10T12:01:42Z",
      "created_at": "2026-03-10T12:00:00Z",
      "credits": {
        "consumed": 0.3,
        "estimated": 0.6
      },
      "errors": [
        {
          "code": "job_failed",
          "title": "External contact data provider timeout"
        }
      ],
      "status": "running"
    },
    "id": "job_550e8400",
    "type": "find_contact_data_job"
  },
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

  • cfe89c1fc59dRevision changes
    • breaking

      the /// response's property type changed from integer to number for status

  • 5d15ed543ab8Revision changes
    • breaking

      the /// response's property type changed from integer to number for status