---
title: "Get Find Contact Data Job Status"
method: GET
path: "/v1/contacts/find-contact-data-jobs/{job_id}"
tags: ["Contacts", "Enrichment", "v1"]
---

# Get Find Contact Data Job Status

`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: one of:
  - API key in header `X-Api-Key`
  - OAuth 2
    - Authorization code: `https://api.leadfeeder.com/v1/oauth/authorize`
    - Token URL: `https://api.leadfeeder.com/v1/oauth/token` scopes: `contacts:read`

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.
:::

## Path parameters

- `job_id` string, required

## Query parameters

- `account_id` string, required

## Response `200`

Job status retrieved

- object
  - `data` FindContactDataJobV1, required
    - `attributes` object, required
      - `completed_at` string, date-time, nullable: When the job completed (null while running)
      - `configuration` object: Echoed request configuration. Present once the job has started. Reflects the caller's input shape: either `contact_ids` or `list_id`.
        - `contact_ids` string[]: Contact IDs submitted for enrichment. Mutually exclusive with `list_id`.
        - `list_id` string: List ID targeted for enrichment. Mutually exclusive with `contact_ids`.
      - `created_at` string, date-time, required: When the job was created
      - `credits` object: Credit consumption details
        - `consumed` number: Credits consumed so far. Some job types are priced per record at a fractional rate, so this can be a decimal.
        - `estimated` number: Credits estimated for the job. Some job types are priced per record at a fractional rate, so this can be a decimal.
      - `errors` object[]: Present only when status is `failed`
        - `code` string, required: Machine-readable error code
        - `title` string, required: Human-readable error description
      - `status` 'running' | 'completed' | 'failed', required: Current status of the job
      - `summary` object: Record processing summary
        - `failed` integer: Records that failed enrichment
        - `succeeded` integer: Records enriched successfully
        - `total` integer: Total records to process
    - `id` string, required: Unique job identifier
    - `type` string, required
  - `meta` object, required
    - `request_id` string, required: A unique identifier assigned to each API request for end-to-end traceability.

## Other responses

- `401`: Unauthorized. The request was rejected because the credentials are missing, invalid, expired, or have been revoked. The client must re-authenticate before retrying. Clients can differentiate via the `code` value of the first item in `errors`.
- `403`: Forbidden. The credentials are valid but the caller is not authorized to perform the request — typically because the user lacks the required permission, the OAuth scope is insufficient, the subscription plan does not include the required entitlement, the `account_id` does not belong to the authenticated user, or the target list is read-only and its members cannot be modified. Clients can differentiate via the `code` value of the first item in `errors`.
- `404`: Not found
- `429`: Too many requests. Either the per-second rate limit or the monthly quota configured for the API key / OAuth application has been exceeded. Clients can differentiate via the `code` value of the first item in `errors`.
- `500`: Internal server error

## Changes

> 46 revisions in range; 1 not diffed.

- **2026-10-23** `cfe89c1fc59d`: 1 breaking
  - the `data/attributes/credits/consumed` response's property type changed from `integer` to `number` for status `200`
- **2026-09-18** `5d15ed543ab8`: 1 breaking
  - the `data/attributes/credits/estimated` response's property type changed from `integer` to `number` for status `200`
- **2026-09-03** `ac752c6c2be0`: 5 info
  - added the optional property `errors/items/source` to the response with the `401` status
  - added the optional property `errors/items/source` to the response with the `403` status
  - added the optional property `errors/items/source` to the response with the `404` status
  - added the optional property `errors/items/source` to the response with the `429` status
  - …1 more
- **2026-07-13** `12ae8a6b9fad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/leadfeeder/apis/leadfeeder-public-api/changes/v1/contacts/find-contact-data-jobs/:job_id/get.md)

---

[API](https://skmtc.dev/leadfeeder/apis/leadfeeder-public-api.md) - [All operations](https://skmtc.dev/leadfeeder/apis/leadfeeder-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/leadfeeder/apis/leadfeeder-public-api/revisions/686d4e39eb05?raw)