List email finder items

application/json

• objectanyrequired
  Alwaysemail_finder_item_list
• jobEmailFinderJobrequired
  ›Show fieldsHide fields

  • objectanyrequired
    Alwaysemail_finder_job
  • idstringrequired
  • statusstringrequired
    One ofQueuedRunningCompletedErrorCanceled
  • status_detailstring | null
  • countsobject
    ›Show fieldsHide 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 fieldsHide fields

    • jobEndpointstring · uri
    • itemsEndpointstring · uri
    • csvEndpointstring · uri
• itemsarray of EmailFinderItemrequired
  ›Show fieldsHide fields

  • objectanyrequired
    Alwaysemail_finder_item
  • idstringrequired
  • inputstringrequired
  • linkedin_idstring | null
  • linkedin_urlstring · uri | null
  • statusstringrequired
    One ofQueuedRunningFoundNot FoundUncertainSuppressedError
  • first_namestring | null
  • last_namestring | null
  • full_namestring | null
  • titlestring | null
  • headlinestring | null
  • locationstring | null
  • countrystring | null
  • companystring | null
  • company_domainstring | null
  • company_urlstring · uri | null
  • company_sourcestring | null

    Safe source label for the resolved company field or company URL.

  • emailstring | null
  • confidenceinteger | null
    ≥ 0 · ≤ 100
  • verification_statusstring | null
  • verification_providerstring | null
  • verification_resultstring | null
  • verification_sub_statusstring | null

    Safe external-provider sub-status when an explicit provider mode is enabled. Raw provider payloads are not returned.

  • identity_sourcestring | null

    Safe source label for resolved identity fields, for example input_hints, linkedin_profile, linkedin_public_preview, or google_public_evidence.

  • identity_confidenceinteger | null
    ≥ 0 · ≤ 100
  • domain_sourcestring | null

    Safe source label for the resolved company domain, for example input_hints, company_homepage, or google_public_evidence.

  • pattern_sourcestring | null

    Safe source label for the email pattern used when returning an uncertain generated candidate.

  • candidate_patternstring | null

    Pattern used to generate the returned candidate, for example first.last.

  • pattern_confidenceinteger | null
    ≥ 0 · ≤ 100
  • confidence_reasonstring | null

    Human-readable reason for the confidence score and final status.

  • confidence_bucketstring | null

    Derived confidence bucket. likely is still returned with API status Uncertain unless strict deliverability proof exists.

    One oflikelyuncertainlownull
  • confidence_scoreinteger | null
    ≥ 0 · ≤ 100
  • uncertain_bucketstring | null

    Safe reason bucket for Uncertain items.

    One oflikelycatch_allprotectedgreylistedtimeouttemporary_failureunknownlownull
  • likely_reasonstring | null

    Short safe reason explaining why a generated candidate is likely.

  • retry_afterstring | null

    ISO timestamp for the next SMTP-safe retry when the failure is greylisted, timeout, or temporary.

  • retry_strategystring | null

    Safe retry policy label, such as smtp_soft_failure_retry_15m.

  • unknown_reasonstring | null

    Safe explanation when a generated candidate remains lower-confidence or inconclusive.

  • smtp_infra_reasonstring | null

    Sanitized SMTP infrastructure reason. Raw SMTP transcripts are never returned.

  • smtp_classificationstring | null

    Sanitized SMTP classification such as catch_all, protected, greylisted, timeout, or temporary_failure.

  • domain_behaviorstring | null

    Safe domain behavior label learned from DNS/MX and SMTP-safe checks.

  • source_providerstring | null

    For the owned resolver this is normally lempile_owned_public_evidence or null.

  • diagnosticsobject