Skip to main content
GET
/
lead_finder
/
async
/
{request_id}
Get Lead Finder request results
curl --request GET \
  --url https://app.bettercontact.rocks/api/v2/lead_finder/async/{request_id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "f4eaa33f3d6fd1d8e1a7",
  "credits_left": "993.3",
  "credits_consumed": "5.5",
  "status": "terminated",
  "summary": {
    "leads_found": 55
  },
  "leads": [
    {
      "contact_id": 32680300,
      "contact_full_name": "Frédéric Bonnand",
      "contact_first_name": "Frédéric",
      "contact_last_name": "Bonnand",
      "contact_job_title": "Founder @bettercontact",
      "contact_seniority": "Founder",
      "contact_headline": "Find emails and phones with bettercontact waterfall enrichment",
      "contact_industry": "Information technology & services",
      "contact_linkedin_profile_url": "https://www.linkedin.com/in/fbonnand",
      "contact_linkedin_id": "<string>",
      "contact_location_continent": "Europe",
      "contact_location_country": "France",
      "contact_location_state": "<string>",
      "contact_location_city": "<string>",
      "contact_city": "<string>",
      "contact_location": "<string>",
      "contact_country_code": "<string>",
      "contact_email_address": "<string>",
      "contact_email_address_status": "<string>",
      "contact_email_address_provider": "<string>",
      "contact_phone_number": "<string>",
      "contact_phone_number_cc": "<string>",
      "contact_additional_phone_number": "<string>",
      "contact_avatar": "<string>",
      "contact_gender": "<string>",
      "contact_activity": "<string>",
      "contact_followers": "<string>",
      "contact_connections": "<string>",
      "contact_experience": "<string>",
      "contact_current_company": "<string>",
      "contact_people_also_viewed": "<string>",
      "contact_posts": "<string>",
      "company_id": "<string>",
      "company_name": "Bettercontact",
      "company_domain": "bettercontact.rocks",
      "company_description": "Bettercontact aggregates 20+ premium contact data providers such as people data labs, rocketreach, and datagma into one subscription.",
      "company_about": "<string>",
      "company_logo": "<string>",
      "company_image": "<string>",
      "company_size": "<string>",
      "company_linkedin_url": "https://www.linkedin.com/company/bettercontact",
      "company_linkedin_id": "<string>",
      "company_website": "<string>",
      "company_crunchbase_url": "<string>",
      "company_directions_url": "<string>",
      "company_industry": "Software development",
      "company_industries": "<string>",
      "company_industry_code": "<string>",
      "company_type": "privately_held",
      "company_organization_type": "<string>",
      "company_founded": "<string>",
      "company_founded_year": 2022,
      "company_funding": "<string>",
      "company_investors": "<string>",
      "company_stock_info": "<string>",
      "company_similar": "<string>",
      "company_specialities": "<string>",
      "company_employees": "<string>",
      "company_employees_number": "<string>",
      "company_employees_in_linkedin": "<string>",
      "company_employees_range_start": 11,
      "company_employees_range_end": 50,
      "company_followers": "<string>",
      "company_head_quarters_city": "Lyon",
      "company_head_quarters_country": "France",
      "company_headquarters": "<string>",
      "company_address_street": "<string>",
      "company_address_city": "<string>",
      "company_address_state": "<string>",
      "company_address_country": "<string>",
      "company_address_zipcode": "<string>",
      "company_formatted_locations": "<string>",
      "company_country_code": "<string>",
      "company_phone_number": "<string>",
      "company_legal_id": "<string>",
      "company_legal_name": "<string>",
      "custom_fields": []
    }
  ]
}

Authorizations

X-API-Key
string
header
required

Path Parameters

request_id
string
required

Response

Request results retrieved successfully

id
string
Example:

"f4eaa33f3d6fd1d8e1a7"

credits_left
string
Example:

"993.3"

credits_consumed
string
Example:

"5.5"

status
string
Example:

"terminated"

summary
object
leads
object[]