×

Response Example

API Documentation

Introduction

Welcome to the Lusha API documentation!

Lusha provides a RESTful API that allows you to query a comprehensive dataset of business profiles and company information. The API offers three main endpoints:

Person API - retrieve contact data for a business profile.

Company API - retrieve company data based on domain or company name.

Prospecting API - query Lusha’s extensive database based on specific criteria (such as industry, seniority, location, and more) to retrieve detailed contact and company information.

All API requests should be made over HTTPS (SSL), and the response bodies are delivered in JSON format.

Data Source and Privacy

Please note that Lusha is a search platform, meaning the data provided is not created or directly managed by us. Instead, it is retrieved from publicly available sources and through contributions from trusted business partners.

For more information on how we collect, use, and handle business profiles, please refer to our Privacy Policy.

Authentication

To access the Lusha API, you must authenticate your requests using your API key. This key is unique to your account and is used to identify your usage of the API.

How to Authenticate

When making an API call, include your API key in the Authorization header of the request.

Important Notes

  • To obtain your API key, please visit the following link: https://dashboard.lusha.com/enrich/api.

  • Your API key is sensitive and should be kept private. Do not share it with anyone outside of your organisation.

  • The API key is used to track and manage your usage of the API, so ensure it is protected from unauthorised access.

Error Handling

Lusha API uses standard HTTP response codes to indicate the status of your request. These codes help you understand whether the request was successful or if there was an issue.

HTTP Status codes

200 OK – Successful request

400 Bad request – Badly formatted request

401 Unauthorised – The API key is invalid

403 Unauthorised – Your account is not active. Please reach out to support at support@lusha.com for assistance.

404 Not found – The requested endpoint was not found

412 - The request failed due to invalid syntax that was provided. Please make sure to send a full name field that contains a valid first & last name.

429 Limit reached – You’ve reached your trial limit, please contact support for upgrade

451 - We are unable to process this contact request due to our GDPR regulations.

499 - Request failed due to request timeout.

5XX Server error – There’s a problem on Lusha’s end

Error Response Format

In case of an error, the response body will contain details about the error.

Notes

  • Always ensure your API key is correct and valid.

  • Pay attention to the specific error message and code to troubleshoot issues more efficiently.

Rate Limiting

Lusha API enforces rate limiting to ensure fair usage and protect against excessive load. You can make up to 50 requests per second to each API endpoint.

Check Rate Limit Status

To monitor your current rate limit status, check the HTTP response headers in your API calls. These headers provide real-time information about your usage.

Rate Limit Headers

Header

Description

RateLimit-Limit

The total number of allowed requests per second.

RateLimit-Remaining

The number of remaining requests you can make in the current window.

RateLimit-Reset

The time (in seconds) until the rate limit quota is reset.

Notes

  • If you exceed the rate limit, you will receive a 429 “Too Many Requests” error.

  • Be sure to respect the rate limit to avoid hitting the cap and to ensure a smooth API experience.

Credit Usage

The Credit Usage API allows you to check your current account’s credit usage, including how many credits have been consumed and how many remain. The credit usage information is categorised by credit type.

Endpoint URL

GET https://api.lusha.com/account/usage
Rate Limit

The Credit Usage API has a rate limit of 5 requests per minute. Ensure you stay within this limit to avoid receiving a 429 Too Many Requests error.

Credit Usage Attributes

The Credit Usage API returns the following attributes related to your account’s credit usage:

total: The initial amount of credits your account started with.

used: The number of credits that have been consumed from the total available credits.

remaining: The number of credits left after subtracting the used credits from the total.

{
    "usage": {
        "bulkCredits": {
            "total": 115169,
            "used": 84128,
            "remaining": 31041
        }
    }
}
Credit Deduction

A credit will be deducted for each successful contact match. A successful match occurs when a request yields results.

Person API

The Person API allows you to look up detailed information about a person using various identifiers, such as their email, LinkedIn URL, full name, company name, or company domain. You can retrieve key data points like Location, Email, Phone number, Social network URLs.

HTTP Request Methods

You can send an HTTP request to the Person API using GET or POST methods, depending on the endpoint and the type of request you are making.

Bulk Person API

The Bulk Person API allows you to process up to 100 objects per request, making it more efficient for large-scale queries. This reduces the number of API calls and integrates easily with other systems, saving both time and resources.

Credit Usage: Each successful contact match will consume one credit.

Person API V2

Endpoint URL

GET https://api.lusha.com/v2/person

HTTP Parameters

To make a request, you must include one or more of the following parameters.

Parameter

Type

Description

firstName

String

The first name of the person (e.g., Dustin).

lastName

String

The last name of the person (e.g., Moskovitz).

companyName

String

The name of the company the person works at (e.g., Lusha).

companyDomain

String

The domain name of the company (e.g., https://lusha.com or lusha.com or www.lusha.com).

email

String

The email address of the person (e.g., dustin@lusha.com).

linkedinUrl

String

The LinkedIn URL of the person (e.g., https://www.linkedin.com/in/dustin/).

filterBy

String

Filters results based on specific contact details. Use ?filterBy=phoneNumbers to get phone numbers, or ?filterBy=emailAddresses to get emails. By default, results will include at least one contact detail.

refreshJobInfo

Boolean

Set refreshJobInfo=true to refresh and update the job details for the person. This ensures that outdated job information is replaced with the most recent data.

Note that the combination of one of the following is required:

linkedinURL OR

email OR

firstName AND lastName AND (companyName OR companyDomain)

Important note

  • All HTTP parameters for the Lusha API are case-sensitive.

Response Fields

The response will include the following fields, depending on the data available.

Property

Type

Description

firstName

String

The first name of the person (e.g., Dustin).

lastName

String

The last name of the person (e.g., Moskovitz).

fullName

String

The full name of the person (e.g., Dustin Moskovitz).

companyId

Number

A unique identifier for the company on Lusha (note that values may be removed or merged without a change history).

contactTags

String[]

Tags manually added by account users for the contact on Lusha.

emailAddresses.email

String

The email address of the person (e.g., dustin@lusha.com).

emailAddresses.emailType

String

The type of email (e.g., 'work').

emailAddresses.emailConfidence

String

Confidence level of the email (e.g., A, A+).

phoneNumbers.number

String

The phone number of the person (e.g., "+972 54-629-5010").

phoneNumbers.phoneType

String

The type of phone number (e.g., Mobile, Direct).

phoneNumbers.doNotCall

Boolean

Indicates whether the phone number is listed as "Do Not Call" (DNC).

location.country

String

The country where the contact is located.

location.country_iso2

String

The two-letter country code (ISO 2) of the contact’s location.

location.continent

String

The continent where the contact is located.

location.is_eu_contact

String

Indicates whether the contact is located in the European Union (EU).

location.state

String

The state or province where the contact is located.

location.state_code

String

The state or province code (e.g., CA for California).

location.city

String

The city where the contact is located.

location.city_id

Integer

A unique identifier for the city.

location.location_coordinates

Number[]

Coordinates (latitude, longitude) of the contact’s location.

jobTitle.title

String

The job title of the person at their current company.

jobTitle.departments

String[]

The department(s) associated with the person's job title (e.g., Engineering, Marketing).

jobTitle.seniority

String

The seniority level of the person (e.g., Manager, Director).

socialLinks.linkedin

String

The LinkedIn profile URL of the person.

jobStartDate

String

The start date of the person’s current job role.

previousJob.company.name

String

The name of the company where the person worked previously.

previousJob.company.domain

String

The domain name of the previous employer (e.g., https://previous-company.com).

previousJob.jobTitle.title

String

The job title held by the person at their previous company.

previousJob.jobTitle.departments

String[]

Department(s) associated with the previous job title (e.g., Engineering, HR).

previousJob.jobTitle.seniority

String

The seniority level associated with the person's previous job title (e.g., Senior Developer, VP).

company.name

String

The name of the company where the person currently works.

company.description

String

A description of the company.

company.domains.homepage

String

The homepage URL of the company.

company.domains.email

String

The domain used for company emails.

company.homepageUrl

String

The homepage URL of the company.

company.fqdn

String

The fully qualified domain name (FQDN) of the company.

company.location.city

String

The city where the company is located.

company.location.continent

String

The continent where the company is located.

company.location.country

String

The country where the company is located.

company.location.rawLocation

String

The full address of the company’s location.

company.location.countryIso2

String

The two-letter country code (ISO 2) where the company is located.

company.location.state

String

The state or province where the company is located.

company.location.stateCode

String

The state or province code where the company is located.

company.location.locationCoordinates

Number[]

Coordinates (latitude, longitude) of the company’s location.

company.companySize

Number[]

The range of the company’s size (e.g., 51–200 employees).

company.revenueRange

Number[]

The estimated revenue range of the company.

company.logoUrl

String

The URL of the company’s logo.

company.social.linkedin

String

The LinkedIn profile URL of the company.

company.social.crunchbase

String

The Crunchbase profile URL of the company.

company.specialities

String[]

The specialties or industries associated with the company.

company.technologies

Technology[]

List of technologies used by the company.

company.funding

Funding

Details about the company’s funding activities.

company.intent

Intent[]

Topics detected based on mapped topics in your account.

company.mainIndustry

String

The primary industry sector the company operates in (e.g., Technology, Healthcare).

company.subIndustry

String

The specific sub-sector within the main industry (e.g., Software, Biotech).

Person Bulk API V2

The Person Bulk API V2 allows you to query multiple person profiles in a single request.

Endpoint URL

POST https://api.lusha.com/v2/person

Request Parameters

  1. contacts (Array of Contact Parameters)

This is a required parameter that should contain a list of contact objects. Each contact will be processed based on the provided contact details.

  1. metadata (Object)

This optional object can contain the following properties:

filterBy (String)
Filters the results based on specific contact details. Use the following options:

"phoneNumbers": Only return contacts with a phone number.

"emailAddresses": Only return contacts with an email address.

refreshJobInfo (Boolean)
Set this to true to refresh job information for the contact. This replaces any outdated job details with the most current information.

By default, Lusha returns results for records that have at least one of the specified contact details (e.g., phone number or email address).

Contact Parameters

Note that the combination of one of the following is required:

linkedinURL OR

email OR

fullName AND (companyName OR companyDomain)

Parameter

Type

Description

contactId

String

Required. A unique sequential ID to associate with the contact object in the API response (e.g., "1").

fullName

String

The full name of the person (e.g., "Dustin Moskovitz").

location

String

Optional. The raw location of the person (e.g., "Singapore", "Chicago").

email

String

The email address of the person (e.g., "dustin@lusha.com").

linkedinUrl

String

The LinkedIn URL of the person (e.g., https://www.linkedin.com/in/dustin/).

companies

Company Parameters

Optional. Details of the company where the contact is currently employed (or previously employed if applicable)

Company Parameters

Parameter

Required

Type

Description

name

Required if no domain

String

The name of the company (e.g., "Lusha").

domain

Required if no name

String

The domain name of the company (e.g., https://lusha.com).

isCurrent

Required

Boolean

Indicates whether this is the person's current company (e.g., true).

jobTitle

Optional

String

The person's job title at the company.

fqdn

Optional

String

Fully qualified domain name of the company (e.g., https://lusha.com).

companySocialId

Optional

String

The social ID associated with the company (if available).

Response Fields

The response will return a set of Contacts and Companies objects, which are encapsulated by the unique contactId and companyId from the request.

Company API

The Company API allows you to retrieve detailed company information based on a company’s domain or name.

Endpoint URL

GET https://api.lusha.com/company

Request Parameters

To make a request, you must include at least one of the following parameters: companyID, company, Domain.

Parameter

Type

Description

companyId

String

A unique identifier for a Lusha company.

Note: Values may be removed or merged. No management system exists to log historical changes for companyId.

This field is intended for deprecation in the future.

company

String

The name of the company (e.g., Lusha).

domain

String

The domain name associated with the company (e.g., https://lusha.com/).

Response Fields

The response will include the following fields, depending on the data available.

Property

Type

Description

id

Number

A unique identifier for the Lusha company.

Note: Values may be removed or merged. No management system exists to log historical changes for id.

description

String

A brief description of the company.

domain

String

The domain name associated with the company’s email addresses.

employees

String

The company’s employee size range.

founded

String

The date the company was founded.

fqdn

String

The Fully Qualified Domain Name (FQDN) of the company.

logoUrl

String

The URL of the company’s logo.

name

String

The name of the company.

revenueRange

Number[]

The company’s revenue range.

mainIndustry

String

The primary industry sector in which the company operates.

subIndustry

String

The specific sub-sector within the primary industry.

social

Object

Social media links associated with the company.

social.crunchbase.url

String

The Crunchbase profile URL of the company.

social.linkedin.url

String

The LinkedIn profile URL of the company.

address

String

The full address of the company’s location.

location

Object

An object containing the company’s location details.

location.city

String

The city where the company is located.

location.country

String

The country where the company is located.

location.fullLocation

String

The complete address of the company’s location.

location.state

String

The state where the company is located.

location.stateCode

String

The state code where the company is located.

location.countryIso2

String

The ISO 2-letter country code where the company is located.

location.rawLocation

String

The detailed address of the company.

categories

String[]

LinkedIn industry tags for the company.

website

String

The company’s website URL.

specialties

String[]

LinkedIn specialties tags associated with the company.

funding

Funding

Details regarding the company’s funding activities.

intent

Intent[]

A list of detected intent topics related to the company based on your account’s mapped topics.

technologies

Technology[]

A list of technologies used by the company.

meta

Object

Currently returns an empty value; this field should be deprecated in future releases.

Notes

  • Deprecation Notice: The companyId and meta fields will be deprecated in future versions. Plan to migrate to new field structures.

  • Response Changes: There are no management systems to track historical changes for companyId or id values. These fields may be subject to changes without versioning.

Company Bulk API

Endpoint URL

POST https://api.lusha.com/bulk/company
Request body example
{
  "companies": [
    {
      "id": "1",
      "domain": "lusha.com"
    },
    {
      "id": "2",
      "name": "Google"
    }
  ]
}

Request Parameters

Parameter

Required?

Type

Description

companies

Required

Object[]

A list of company objects that you want to query in bulk.

id

Required

String

A unique sequential ID associated with each company. This ID is used to correlate the provided company object with the API response (e.g., “1”).

fqdn

Optional (if domain or name is not provided)

String

The Fully Qualified Domain Name (FQDN) of the company.

domain

Optional (if fqdn or name is not provided)

String

The domain name of the company (e.g., "lusha.com").

name

Optional (if fqdn or domain is not provided)

String

The name of the company (e.g., "Lusha").

Response Fields

The response object returns the following properties for each company in the companies array.

Property

Type

Description

id

Number

A unique identifier for the Lusha company.

Note: Values may be removed or merged. There is no management system to track historical changes for id.

description

String

A brief description of the company.

domain

String

The domain name of the company’s email.

companySize

String

The size range of the company, based on the number of employees.

founded

String

The date the company was founded.

fqdn

String

The Fully Qualified Domain Name (FQDN) of the company.

logoUrl

String

The URL of the company’s logo.

name

String

The name of the company.

revenueRange

Number[]

The company’s revenue range.

mainIndustry

String

The primary industry sector in which the company operates.

subIndustry

String

The specific sub-sector within the main industry.

crunchbase

String

The Crunchbase profile URL of the company.

linkedin

String

The LinkedIn profile URL of the company.

city

String

The city where the company is located.

country

String

The country where the company is located.

state

String

The state where the company is located.

countryIso2

String

The 2-letter ISO country code where the company is located.

continent

String

The continent where the company is located.

rawLocation

String

The detailed address of the company.

specialties

String[]

LinkedIn specialties tags associated with the company.

industryTags

String[]

LinkedIn industry tags associated with the company.

funding

Funding

Details about the company’s funding activities.

intent

Intent[]

A list of detected intent topics for the company based on your account’s mapped topics.

technologies

Technology[]

A list of technologies used by the company.

Prospecting API

With Lusha’s Prospecting API, you can query Lusha’s extensive database based on specific criteria (such as job title, seniority, location, and more) to retrieve detailed contact and company information.

The Prospecting API is designed to help you generate new records (contacts or leads) for your CRM system, using filters that align with your Ideal Customer Profile (ICP).

This process involves three main steps:

Filters API: (1) Apply filters to refine your search.

Search API: (2) Query Contacts or Companies using the available filters.

Enrich API: (3) Get full details of Contacts and Companies from the search results.

This guide will provide a detailed explanation of each stage.

Important Notes:

  • The API KEY header is mandatory for every request to our service.

  • A credit is charged only in the final step (Step 3: Enrich API).

Filters API

Several filters are available for specific objects like contacts and companies. These filters allow you to narrow down your search results by applying various criteria.

Filters API Endpoint Base URL

https://api.lusha.com/prospecting/filters/

Contact Filters

Filter Name

Path Name

Method

Example Response

Department

/contacts/departments

GET

Example Response: ["Business Development", "Consulting"]

Seniority

/contacts/seniority

GET

Example Response: ["Executive", "Vice President"]

Existing Data Points

/contacts/existing_data_points

GET

Example Response: ["phone", "work_email"]

Countries

/contacts/all_countries

GET

Example Response: [ { "name": "United States", "code": "US" }]

Locations

/contacts/locations

POST

Example Request: {"text": "un"}

Example Response: [ { "continent": "North America", "country": "United States" }]

Company Filters

Filter Name

Path Name

Method

Example Request/Response

Company Name

/companies/names

POST

Example Request: {"text": "lusha"}

Example Response: [{ "companyId": 33222678, "name": "Lusha", "logoUrl": "https://logo.lusha.co/d/company_33222678_logo.jpg", "fqdn": "www.lusha.com" }]

Industry Labels

/companies/industries_labels

GET

Example Response: [{ "main_industry": "Hospitality", "sub_industries": [{"value": "Other", "id": 778}, {"value": "Food & Beverage Services", "id": 1}] }]

Company Size

/companies/sizes

GET

Example Response: [{ "min": 1, "max": 10 }]

Revenue

/companies/revenues

GET

Example Response: [{ "min": 1, "max": 1000000 }]

Location

/companies/locations

POST

Example Request: {"text": "Israel"}

Example Response: [ { "country": "United States", "continent": "North America", "country_grouping": "na" }]

SIC Codes

/companies/sics

GET

Example Response: [ { "code": "1011", "label": "Iron ores" }]

NAICS Codes

/companies/naics

GET

Example Response: [ { "code": "11", "label": "Agriculture, Forestry, Fishing and Hunting" }]

Intent Topics

/companies/intent_topics

GET

Example Response: ["Android", "Accounting", "Zero Trust"]

Technologies

/companies/technologies

POST

Example Request: {"text": "rss"}

Example Response: [ { "name": "rss" }, { "name": "webrss" }]

Location Filters Parameters

Parameter

Type

Details

city

String

City name, max 30 characters

state

String

State name, max 30 characters

country

String

Country name, max 30 characters

continent

String

Continent name, max 30 characters

country_grouping

String

Country grouping for filtering (e.g., regions)

Technology object

The technologies object provides a list of technologies used by the company.

{

   "name": string

}

  • Please note that the technologies visible in the API are determined by the admin through the account export settings in the platform.

Technology Properties

Property

Type

Description

name

String

The name of a technology used by the company.

Funding object

The funding object provides details about the company's funding history.

{

  "rounds":

              { "currency": string,

                "roundAmount": number,

                "roundType": string,

                "roundDate": string

              }[], 

  "totalRounds": number,

  "totalRoundsAmount": number,

  "currency": string,

  "isIpo": boolean,

  "lastRoundType": string,

  "lastRoundAmount": number,

  "lastRoundDate": string

}

Funding Properties

Property

Type

Description

rounds

Object[]

An array of funding rounds history. Each object in the array contains the funding round details.

totalRounds

Number

The total number of funding rounds the company has undergone.

totalRoundsAmount

Number

The total amount raised in all funding rounds.

currency

String

The currency of the funding amounts (e.g., USD, EUR).

isIpo

Boolean

Indicates if the company has gone public (IPO).

lastRoundType

String

The type of the most recent funding round (e.g., Series A, Seed).

lastRoundAmount

Number

The amount raised in the most recent funding round.

lastRoundDate

String

The date of the most recent funding round.

Funding Round Details

Property

Type

Description

roundType

String

Type of the funding round (e.g., Seed, Series A).

roundAmount

Number

The amount raised in the funding round.

roundDate

String

The date of the funding round.

currency

String

The currency of the round amount (e.g., USD, EUR).

Intent object

The intent object provides details about the detected topics for a given company.

{

  "detectedTopics": {

   "topicName": string,

   "metadata": {

      "topicScore": number,

      "topicTrend": string

    }

  }[],

  "topicCount": number

}

  • Please note that the intent topics visible in the API are determined by the admin through the account settings for Intent mapping in the platform.

Intent Properties

Property

Type

Description

detectedTopics

DetectedTopics[]

An array of intent topics detected for the company. Each topic includes metadata such as score and trend.

topicCount

Number

The number of intent topics detected for the company based on your account’s mapped topics.

Detected Topics Metadata

Property

Type

Description

topicName

String

The name of the intent topic detected for the company, based on the topics mapped in your account.

topicScore

Number

The score of the intent topic for the specific company. Scores range from 60 to 100.

topicTrend

String

The trend of the topic score compared to the previous week. Possible values: "+" (positive), "-" (negative), or "New" (indicating a new topic).

Search API

Search Contacts

To search for Contacts, select the available contact filters needed and use the following endpoint:

Endpoint URL

POST https://api.lusha.com/prospecting/contact/search

Headers:

api_key: API_KEY

Request Body Example
{
  "pages": { "page": 0, "size": 40 },
  "filters": {
    "contacts": {
      "include": {
        "departments": ["Engineering & Technical"],
        "seniority": ["2"]
      }
    },
    "companies": {
      "include": {
        "names": ["Apple"]
      }
    }
  }
}

Search Parameters

Parameter

Type

Description

pages

Object

Contains page (0–1000, default 0) and size (10–40, default 20).

offset

Object

Contains index (0–10000, default 0) and size (1–500, default 40).

filters

Object

Object containing Contact Filters

Search Contacts Response Fields

Property

Type

Description

requestId

string

The unique request ID used for subsequent enrichment requests.

currentPage

number

The current page of the search results.

totalResults

number

The total number of search results (contacts or companies).

Contacts data

object[]

Array of Contact Data

Contact Data

Property

Type

Description

contactId

string

A unique serial contact ID generated for each search response

isShown

boolean

Indicates whether the contact was already revealed by any of the account users

name

object

Contains all name objects

name.raw

string

Full name of the person (e.g., Dustin Moskovitz)

name.full

string

Full name of the person (e.g., Dustin Moskovitz)

name.first

string

First name of the person (e.g., Dustin)

name.last

string

Last name of the person (e.g., Moskovitz)

jobTitle

string

The job title held by the person at their current company

companyId

number

A unique identifier for a Lusha company (can be removed or merged, no history management system)

companyName

string

The name of the company where the person currently works

fqdn

string

The fqdn of the company

companyDescription

string

A description of the company

logoUrl

string

The URL of the company’s logo

hasCompanyEmployeesCount

boolean

Indicates whether Lusha has company size data, based on filters set

hasCompanyRevenue

boolean

Indicates whether Lusha has company revenue data, based on filters set

hasCompanyMainIndustry

boolean

Indicates whether Lusha has company main industry data, based on filters set

hasCompanySubIndustry

boolean

Indicates whether Lusha has company sub industry data, based on filters set

hasCompanyFunding

boolean

Indicates whether Lusha has company funding data, based on filters set

hasCompanyIntent

boolean

Indicates whether Lusha has company intent data, based on filters set

hasCompanyTechnologies

boolean

Indicates whether Lusha has company technologies data, based on filters set

hasDepartment

boolean

Indicates whether Lusha has department data, based on filters set

hasSeniority

boolean

Indicates whether Lusha has seniority data, based on filters set

hasContactLocation

boolean

Indicates whether Lusha has contact location data, based on filters set

hasSocialLink

boolean

Indicates whether Lusha has social links data, based on filters set

hasEmails

boolean

Indicates whether Lusha has contact email data, based on filters set

hasWorkEmail

boolean

Indicates whether Lusha has contact work email data, based on filters set

hasPrivateEmail

boolean

Indicates whether Lusha has contact private email data, based on filters set (relevant for recruiters only)

hasPhones

boolean

Indicates whether Lusha has contact phone data, based on filters set

hasMobilePhone

boolean

Indicates whether Lusha has contact mobile phone data, based on filters set

hasDirectPhone

boolean

Indicates whether Lusha has contact direct phone data, based on filters set

hasCompanyCity

boolean

Indicates whether Lusha has company city data, based on filters set

hasCompanyCountry

boolean

Indicates whether Lusha has company country data, based on filters set

Search Companies

To search for Companies, select the available company filters needed and use the following endpoint:

Endpoint URL

POST https://api.lusha.com/prospecting/company/search

Headers:

api_key: API_KEY

Request Body Example
{
  "pages": { "page": 0, "size": 20 },
  "filters": {
    "companies": {
      "include": {
        "locations": [
          { "country": "United States" }
        ],
        "technologies": ["Amazon"],
        "mainIndustriesIds": ["1", "2"],
        "intentTopics": ["Digital Sales"]
      }
    }
  }
}

Please note that for Industries Labels filter, the nomenclature when creating the request body is as follows (see example above for reference):

"mainIndustriesIds" and "subIndustriesIds"

To perform enrichment based exclusively on Sub Industries, set the mainIndustriesIds parameter to [0], which acts as a bypass for Main Industry filtering.

Search API Parameters

Parameter

Type

Description

pages

Object

Contains page (0–1000, default 0) and size (10–40, default 20).

offset

Object

Contains index (0–10000, default 0) and size (1–500, default 40).

filters

Object

Object containing Company Filters.

Search Companies Response Fields

Property

Type

Description

requestId

string

The requestId that should be used in Prospecting Enrich request API params

currentPage

number

Current page of search results

pageLength

number

Page length

totalResults

number

Total search results (contacts/companies)

Companies data

object[]

An array of Company Data

Company Data

Property

Type

Description

id

number

A unique identifier for a Lusha company (can be removed or merged, no history management system)

name

string

The name of the company where the person currently works

fqdn

string

The fqdn of the company

description

string

A description of the company

logoUrl

string

The URL of the company’s logo

hasCompanyEmployeesCount

boolean

Indicates whether Lusha has company size data, based on filters set

hasCompanyRevenue

boolean

Indicates whether Lusha has company revenue data, based on filters set

hasCompanyMainIndustry

boolean

Indicates whether Lusha has company main industry data, based on filters set

hasCompanySubIndustry

boolean

Indicates whether Lusha has company sub industry data, based on filters set

hasCompanyFunding

boolean

Indicates whether Lusha has company funding data, based on filters set

hasCompanyIntent

boolean

Indicates whether Lusha has company intent data, based on filters set

hasCompanyTechnologies

boolean

Indicates whether Lusha has company technologies data, based on filters set

hasCompanyCity

boolean

Indicates whether Lusha has company city data, based on filters set

hasCompanyCountry

boolean

Indicates whether Lusha has company country data, based on filters set

Enrich API

Enrich Contacts

Endpoint URL

POST https://api.lusha.com/prospecting/contact/enrich

Headers:
api_key: API_KEY

Request body example
{
   "contactIds": [
      "37b4c536-eaec-11ef-ad4b-a75f8e9e1484",
      "392706c1-a8e9-11ef-959f-115143d976cb"
   ],
   "requestId": "b6effae6-35b8-493d-91aa-7d3b1b7c7dc7"
}

Request Parameters

Parameter

Required

Type

Description

requestId

Yes

String

The requestId generated in the Prospecting Search response (UUID).

contactIds

Yes

String[]

An array containing the contact IDs for enrichment. A minimum of 1 ID and a maximum of 100 IDs.

Response Fields

Property

Type

Description

requestId

String

The requestId that was used in the request.

contacts

Object[]

Array of contact objects containing enriched data for each contact.

contacts.id

String

The ID of the contact from the enrichment request.

contacts.isSuccess

Boolean

Indicates whether the enrichment process was successful. Returns false in case of a search timeout.

contacts.data

Object[]

The enriched data for each contact.

contacts.data.firstName

String

The first name of the contact (e.g., "Dustin").

contacts.data.lastName

String

The last name of the contact (e.g., "Moskovitz").

contacts.data.fullName

String

The full name of the contact (e.g., "Dustin Moskovitz").

contacts.data.isShown

Boolean

Indicates whether the contact was already revealed by any of the account users.

contacts.data.jobTitle

String

The current job title of the contact.

contacts.data.location

Object

Location details of the contact.

contacts.data.location.city

String

The city where the contact is located.

contacts.data.location.state

String

The state where the contact is located.

contacts.data.location.country

String

The country where the contact is located.

contacts.data.location.country_iso2

String

The ISO2 country code of the contact's location.

contacts.data.location.continent

String

The continent where the contact is located.

contacts.data.emailAddresses

Object[]

Array of email addresses associated with the contact.

contacts.data.emailAddresses.email

String

The email address of the contact (e.g., "dustin@lusha.com").

contacts.data.emailAddresses.emailType

String

The type of email (e.g., 'work').

contacts.data.emailAddresses.emailConfidence

String

The confidence level of the email address (e.g., "A+" or "A").

contacts.data.phoneNumbers

Object[]

Array of phone numbers associated with the contact.

contacts.data.phoneNumbers.number

String

The phone number of the contact (e.g., "+972 54-629-5010").

contacts.data.phoneNumbers.phoneType

String

The type of phone number (e.g., "Mobile", "Direct", or "Phone").

contacts.data.phoneNumbers.doNotCall

Boolean

Indicates whether the phone number is listed as "Do Not Call".

contacts.data.companyId

Number

A unique identifier for the company the contact works at.

contacts.data.companyName

String

The name of the company where the contact works.

contacts.data.socialLinks.linkedin

String

The LinkedIn profile URL of the contact.

contacts.data.departments

String[]

An array of departments the contact is associated with (e.g., "Engineering", "Marketing").

contacts.data.seniority

Object[]

Array of seniority levels associated with the contact's role.

contacts.data.seniority.id

Number

The seniority level ID (e.g., 5 for "Manager").

contacts.data.seniority.value

String

The seniority value (e.g., "C-suite", "Vice President").

contacts.data.contactLocation

String

The contact's physical location (if applicable).

contacts.data.company

Object

Enriched company details associated with the contact.

contacts.data.company.revenueRange

Number[]

The revenue range of the company.

contacts.data.company.funding

Object

Information on the company's funding, including rounds and amounts.

contacts.data.company.intent

Object

List of intent topics detected for the company.

contacts.data.company.mainIndustry

String

The primary industry sector the company operates in.

contacts.data.company.subIndustry

String

The specific sub-sector within the company's main industry.

contacts.data.company.technologies

Object[]

A list of technologies used by the company.

Enrich Companies

Endpoint URL

POST https://api.lusha.com/prospecting/company/enrich

Headers
api_key: API_KEY

Request body example
{
 "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
 "companiesIds": ["1586"]
}

Request Parameters

Parameter

Required

Type

Description

requestId

Yes

String

The requestId from the Prospecting Search response.

companiesIds

Yes

String[]

An array of company IDs for enrichment. A minimum of 1 ID and a maximum of 100 IDs.

Response Fields

Property

Type

Description

requestId

String

The requestId used in the request.

companies

Object[]

Array of company objects containing enriched data.

companies.id

Number

A unique identifier for the company.

companies.name

String

The name of the company.

companySize.min

Number

The minimum size range of the company, based on the number of employees.

companySize.max

Number

The maximum size range of the company, based on the number of employees.

companySize.employees_in_linkedin

Number

The company size based on its LinkedIn profile.

employees

String

The employee size range of the company (e.g., "10001 - 100000").

revenueRange

Number[]

The revenue range of the company.

fqdn

String

The Fully Qualified Domain Name (FQDN) of the company.

description

String

A brief description of the company.

domains.email

String

The email domain of the company.

domains.homepage

String

The homepage URL of the company.

logoUrl

String

The URL of the company's logo.

industryTags

String[]

LinkedIn industry tags associated with the company.

stateCode

String

The state code where the company is located.

social

Object

Object containing social media links (e.g., LinkedIn).

city

String

The city where the company is located.

state

String

The state where the company is located.

country

String

The country where the company is located.

countryIso2

String

The 2-letter ISO code of the country where the company is located.

continent

String

The continent where the company is located.

rawLocation

String

The full address of the company.

coordinates

Number[]

The geographical coordinates of the company location.

specialities

String[]

LinkedIn specialties/industry tags for the company.

mainIndustry

String

The main industry sector the company operates in.

subIndustry

String

The specific sub-industry sector within the main industry.

funding

Object

Information on the company's funding history.

intent

Object

Intent topics detected for the company.

technologies

Object[]

A list of technologies used by the company.

Legal Guidelines

We work diligently to comply with applicable laws and strive to safeguard individual rights. Thus, we require you to specify for what purpose you obtain our data in order to inquire if the purpose is lawful.

In addition, we specified hereunder important guidelines which applicable to all our API customers and we request that you shall respect them:

a. You shall agree to the terms of our API Agreement and our Privacy Policy.

b. You should not violate privacy rights or intellectual property rights of any third party.

c. You should not use our data for purposes of cookie tracking, ad exchanges, ad networks, data brokerages, SPAM or any other purpose in violation of any applicable law.

d. You shall use our data in compliance with applicable data privacy and protection laws.

e. You shall take adequate security measures to safeguard personally identifiable information you receive from us.

f. You shall respect individuals’ privacy rights and delete personally identifiable information you obtain from us, in case you receive a notification from an individual requiring that you shall delete it.

g. You shall take measures to guarantee that you have the right to upload and share with us information relating to individuals.