v3

OpenAPI 3.1.1mit2026-07-3165481.5 MB
Contacts
Enrichment
v1

Estimate Find Contact Data Job

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.

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

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

Query parameters

account_idstring required

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

Request body

Response

Estimate calculated successfully

Example response

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "attributes": {
      "estimated_total_credits": 2,
      "eligible_contacts": 2
    }
  },
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}