Skip to content
/
Search Single Contact

Lusha API (2.0.0)

Lusha provides a RESTful API that allows you to query a comprehensive dataset of business profiles and company information.

Getting Started

To use the Lusha API, you'll need an API key. Include it in the api_key header with each request.

Main Features

  • Person Search: Find contact information for individuals
  • Company Search: Get detailed company information
  • Account Usage: Monitor your API credit usage
Download OpenAPI description
index2.json
index2.yaml
Overview
URL
https://lusha.com/support
Lusha Support
support@lusha.com
License
Lusha API License
Terms of Service
Languages
Servers
Mock server
https://docs.lusha.com/_mock/apis/index2/
Production server
https://api.lusha.com/
Staging server
https://api-staging.lusha.com/

Person

Search for individual contacts and their information

Operations

Search Multiple Contacts

Request

Enrich multiple contacts in a single request. This endpoint allows you to submit a list of contacts and receive enriched data for each one, including company information.

Rate Limits: Please check your account limits for bulk operations.

Security
ApiKeyAuth
Bodyapplication/jsonrequired

The list of contacts to enrich

contactsArray of ContactSearchBulk (object)required

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

ContactSearchBulk (object)
metadataMetadata (object)

Metadata for the search to filter the results

curl -i -X POST \
  https://docs.lusha.com/_mock/apis/index2/v2/person \
  -H 'Content-Type: application/json' \
  -H 'api_key: YOUR_API_KEY_HERE' \
  -d '{
    "contacts": [
      {
        "contactId": "1",
        "fullName": "John Doe",
        "email": "john@example.com",
        "companies": [
          {
            "name": "Example Corp",
            "domain": "example.com",
            "isCurrent": true
          }
        ]
      }
    ],
    "metadata": {
      "revealEmails": true,
      "revealPhones": true
    }
  }'

Responses

The list of enriched contacts with their company details

Bodyapplication/json
contactsobjectrequired

The contacts of the bulk person output

contacts.​1111ContactResponse (object)
ContactResponse (object)
companiesobjectrequired

The companies of the bulk person output

companies.​123CompanyResponse (object)
CompanyResponse (object)
Response
application/json
{
  "contacts": {
    "1111": { … }
  },
  "companies": {
    "123": { … }
  }
}

Search Single Contact

Request

Find and enrich a single contact using various search criteria. You can search by name, email, LinkedIn URL, or company information.

Search Tips:

  • Provide as much information as possible for better results
  • Use refreshJobInfo=true to get the latest employment data
  • Use filterBy parameter to specify what contact details you need
Security
ApiKeyAuth
Query
firstNamestring

The first name of the person

Example: firstName=Dustin
lastNamestring

The last name of the person

Example: lastName=Moskovitz
companyNamestring

The name of the company the person works at

Example: companyName=Lusha
companyDomainstring

The domain name of the company

Example: companyDomain=lusha.com
emailstring(email)

The email address of the person

Example: email=dustin@lusha.com
linkedinUrlstring(uri)

The LinkedIn URL of the person

Example: linkedinUrl=https://www.linkedin.com/in/dustin/
refreshJobInfoboolean

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

Default false
Example: refreshJobInfo=true
filterBystring

Filters results based on specific contact details. Available options:

  • phoneNumbers: Only return contacts with phone numbers
  • emailAddresses: Only return contacts with email addresses

By default, results will include contacts with at least one contact detail.

Enum"phoneNumbers""emailAddresses"
revealEmailsboolean

Whether to reveal email addresses in the response

Default true
Example: revealEmails=true
revealPhonesboolean

Whether to reveal phone numbers in the response

Default true
Example: revealPhones=true
curl -i -X GET \
  'https://docs.lusha.com/_mock/apis/index2/v2/person?firstName=Dustin&lastName=Moskovitz&companyName=Lusha&companyDomain=lusha.com&email=dustin%40lusha.com&linkedinUrl=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fdustin%2F&refreshJobInfo=true&filterBy=phoneNumbers&revealEmails=true&revealPhones=true' \
  -H 'api_key: YOUR_API_KEY_HERE'

Responses

Successfully found contact information

Bodyapplication/json
contactContactSingleResponse (object)required

The contact response object

contact.​errorContactError (object)required

The error of the contact

ContactError (object)

The error of the contact

contact.​isCreditChargedbooleanrequired

Indicates whether a credit charge was made for the contact

Example: true
contact.​dataContactWithCompany (object)required

The data of the contact and company

ContactWithCompany (object)

The data of the contact and company

Response
application/json
{
  "contact": {
    "error": { … },
    "isCreditCharged": true,
    "data": { … }
  }
}

Company

Search for company information and details

Operations

Account

Manage your account and monitor usage

Operations
Terms
Copyright © Lusha. All rights reserved.