Skip to content
Docs

Create email finder job

POSTapi.lempile.com/email-finder

Creates a queue-first email finder job and returns 202. Poll the job endpoint until it reaches Completed or Error. Inputs can be plain LinkedIn URLs/ids or safe identity records with optional name, company, and company-domain hints. Email Finder checks cache, same-workspace LinkedIn profile identity when a Ready account is available, public LinkedIn profile previews, company-site evidence, public emails, verified domain patterns, generated candidates, and internal syntax/domain/MX/SMTP-safe verification. Google Search evidence is optional last-resort evidence only when the Google evidence pool is ready.

Authentication

X-API-KEY header·A Lempile API key, made in the dashboard under Access tokens.

Request body

  • linkedin_url_or_idsarray of EmailFinderInput

    LinkedIn profile URLs, public identifiers, or safe identity records. Plain strings remain supported for compatibility.

    ≥ 1 items · ≤ 500 items
    ›Show fields
    • Option 1string

      LinkedIn profile URL or public identifier.

    • EmailFinderInputRecordEmailFinderInputRecord

      Safe identity hints for owned evidence resolution. linkedin_url_or_id is required; all other fields are optional.

      ›Show fields
      • linkedin_url_or_idstring

        LinkedIn profile URL or public identifier.

      • linkedin_urlstring

        Accepted alias for linkedin_url_or_id.

      • linkedin_idstring

        Accepted alias for linkedin_url_or_id.

      • first_namestring
      • last_namestring
      • full_namestring
      • companystring
      • company_domainstring

        Company website domain, for example example.com.

      • company_urlstring

        Optional company website or company page URL evidence.

  • recordsarray of EmailFinderInputRecord

    Alternative input field for safe identity records. Use this when you already know names, company, or company domain.

    ≥ 1 items · ≤ 500 items
    ›Show fields
    • linkedin_url_or_idstring

      LinkedIn profile URL or public identifier.

    • linkedin_urlstring

      Accepted alias for linkedin_url_or_id.

    • linkedin_idstring

      Accepted alias for linkedin_url_or_id.

    • first_namestring
    • last_namestring
    • full_namestring
    • companystring
    • company_domainstring

      Company website domain, for example example.com.

    • company_urlstring

      Optional company website or company page URL evidence.

  • optionsobject
    ›Show fields
    • business_email_onlyboolean

      Email Finder defaults to business emails only.

      Defaulttrue
    • profile_resolutionstring

      Use controlled same-workspace Ready LinkedIn accounts for visible profile identity resolution, or public/cache/domain evidence only.

      One ofworkspace_linkedin_accountspublic_onlyDefaultworkspace_linkedin_accounts
    • verification_modestring

      smtp_only is the default internal-owned mode: syntax/domain/MX/SMTP-safe verification only. mx_only disables SMTP recipient checks and uses domain/MX evidence only.

      One ofsmtp_onlymx_onlyDefaultsmtp_only
    • provider_max_candidates_per_iteminteger

      Reserved for future external verifier fallback. Current public jobs are internal-only and this value is clamped to 0.

      Default0≥ 0 · ≤ 20

Responses

202

Email finder job accepted.

›

application/json

  • objectanyrequired
    Alwaysemail_finder_job
  • idstringrequired
  • statusstringrequired
    One ofQueuedRunningCompletedErrorCanceled
  • status_detailstring | null
  • countsobject
    ›Show fields
    • inputinteger
    • completedinteger
    • foundinteger
    • not_foundinteger
    • uncertaininteger
    • errorinteger
    • retryinginteger

      Uncertain items still waiting for a scheduled retry. They can become Found after the job is Completed.

  • next_retry_atstring

    When the next scheduled retry runs (UTC). Present only while counts.retrying is above 0.

  • endpointsobject
    ›Show fields
    • jobEndpointstring · uri
    • itemsEndpointstring · uri
    • csvEndpointstring · uri
400

Invalid input.

›

application/json

  • errorstringrequired
  • messagestring
401

Missing or invalid API key.

›

application/json

  • errorstringrequired
  • messagestring
402

No active trial or subscription (subscription_required), or a trial that used its 1,000 included found emails (email_finder_trial_limit).

›

application/json

  • errorstringrequired
  • messagestring
403

API key lacks email_finder.write.

›

application/json

  • errorstringrequired
  • messagestring
429

Workspace email finder queue is full.

›

application/json

  • errorstringrequired
  • messagestring

Was this page helpful?