Enrichment

Search Single Contact

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

Endpoint

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

Search Requirements

You must provide either:

personId OR
email OR
linkedinUrl OR
firstName AND lastName AND (companyName OR companyDomain)

Notes:

Provide as much information as possible for better results
Using personId provides the most direct way to retrieve contact information, as it uniquely identifies a contact in Lusha’s database.
Use refreshJobInfo=true to get the latest employment data
Use filterBy parameter to specify what contact details you need
Include the signals parameter to retriever contact signals (If no signals data is found for the specified period, the signals object will be empty but still present in the response.)
- When requesting signals, you can optionally specify a start date using signalsStartDate.
- Signals data is optional. If you don’t include the signals parameter, no signals data will be returned.

⚠️ Important Notice - Unified Credits Plan Required

Parameter	Requirement
`revealEmails` and `revealPhones`	Only available to customers on the Unified Credits pricing plan
Plan Restriction	Attempting to use these parameters on other plans will result in a 403 Unauthorized error
Default Behavior	When neither parameter is used, the API returns both email addresses and phone numbers, if available

GET

person

Search Single Contact

curl --request GET \
  --url https://api.lusha.com/v2/person \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://api.lusha.com/v2/person', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lusha.com/v2/person"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "contact": {
    "error": null,
    "isCreditCharged": false,
    "data": {
      "companyId": 33222678,
      "firstName": "Dustin",
      "lastName": "Moskovitz",
      "fullName": "Dustin Moskovitz",
      "emailAddresses": [
        {
          "address": "dustin@lusha.com",
          "type": "work",
          "emailConfidence": "A+",
          "updateDate": "2024-01-15"
        }
      ],
      "phoneNumbers": [
        {
          "number": "+1-555-123-4567",
          "phoneType": "Mobile",
          "doNotCall": false,
          "updateDate": "2024-01-15"
        }
      ],
      "location": {
        "country": "United States",
        "countryIso2": "US",
        "continent": "North America",
        "rawLocation": "Boston, MA, US",
        "city": "Boston",
        "state": "Massachusetts",
        "stateCode": "MA",
        "isEuContact": false
      },
      "jobTitle": {
        "seniority": "Executive",
        "title": "CEO",
        "departments": [
          "Executive"
        ]
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/in/dustin/",
        "xUrl": "https://twitter.com/dustin"
      },
      "jobStartDate": "2020-01-01",
      "personId": 123456,
      "updateDate": "2024-01-15",
      "linkedinFollowersCount": 12500,
      "linkedinConnectionsCount": 500,
      "linkedinCertifications": [
        {
          "companyName": "Microsoft",
          "title": "Microsoft Certified: Azure Fundamentals",
          "dateYear": 2020,
          "dateMonth": 6,
          "verifyUrl": "https://www.youracclaim.com/badges/5ccf865c-dd6e-4dcc-9184-c8999d31f83d"
        }
      ],
      "linkedinCourses": [
        {
          "title": "Advanced Leadership Strategies",
          "companyName": "LinkedIn Learning"
        }
      ],
      "linkedinAwards": [
        {
          "title": "Tech Leader of the Year",
          "companyName": "Tech Awards Council",
          "dateYear": 2023,
          "summary": "Recognition for outstanding leadership in technology innovation"
        }
      ],
      "linkedinSkills": [
        "Strategic Planning",
        "Team Leadership",
        "Product Development"
      ],
      "company": {
        "name": "Lusha",
        "description": "Lusha is the sales intelligence platform designed to help businesses get their next customers.",
        "domains": {
          "homepage": "https://www.lusha.com",
          "email": "lusha.com"
        },
        "fqdn": "lusha.com",
        "location": {
          "country": "United States",
          "countryIso2": "US",
          "continent": "North America",
          "rawLocation": "Boston, MA, US",
          "city": "Boston",
          "state": "Massachusetts"
        },
        "companySize": [
          201,
          500
        ],
        "revenueRange": [
          10000000,
          50000000
        ],
        "logoUrl": "https://logo.lusha.co/logo.jpg",
        "social": {
          "linkedin": "https://linkedin.com/company/lusha",
          "crunchbase": "https://crunchbase.com/company/lusha"
        }
      }
    }
  }
}

Authorizations

api_key

string

header

required

Your Lusha API key. You can find this in your Lusha dashboard under API settings.

Include this key in the api_key header for all requests.

Query Parameters

firstName

string

The first name of the person

lastName

string

The last name of the person

personId

string

The unique person identifier in Lusha

companyName

string

The name of the company the person works at

companyDomain

string

The domain name of the company

string

The email address of the person

linkedinUrl

string

The LinkedIn URL of the person

refreshJobInfo

boolean

default:false

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.

filterBy

enum<string>

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.

Available options:

phoneNumbers,

emailAddresses

revealEmails

boolean

default:true

Set revealEmails=true to retrieve only the email address of the contact.

revealPhones

boolean

default:true

Set revealPhones=true to retrieve only the phone number of the contact.

signals

enum<string>[]

Array of signal types to retrieve for the contact.

allSignals: All available signal types
promotion: Promotion signals
companyChange: Company change signals

Available options:

allSignals,

promotion,

companyChange

signalsStartDate

string<date>

Start date for signal retrieval in YYYY-MM-DD format. Defaults to 6 months ago if not specified.

partialProfile

boolean

default:false

Search for a single contact with the option to receive a partial profile.

Response

Successfully found contact information

contact

object

required

The contact response object

Show child attributes

⌘I

Search Single Contact

curl --request GET \
  --url https://api.lusha.com/v2/person \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://api.lusha.com/v2/person', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lusha.com/v2/person"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "contact": {
    "error": null,
    "isCreditCharged": false,
    "data": {
      "companyId": 33222678,
      "firstName": "Dustin",
      "lastName": "Moskovitz",
      "fullName": "Dustin Moskovitz",
      "emailAddresses": [
        {
          "address": "dustin@lusha.com",
          "type": "work",
          "emailConfidence": "A+",
          "updateDate": "2024-01-15"
        }
      ],
      "phoneNumbers": [
        {
          "number": "+1-555-123-4567",
          "phoneType": "Mobile",
          "doNotCall": false,
          "updateDate": "2024-01-15"
        }
      ],
      "location": {
        "country": "United States",
        "countryIso2": "US",
        "continent": "North America",
        "rawLocation": "Boston, MA, US",
        "city": "Boston",
        "state": "Massachusetts",
        "stateCode": "MA",
        "isEuContact": false
      },
      "jobTitle": {
        "seniority": "Executive",
        "title": "CEO",
        "departments": [
          "Executive"
        ]
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/in/dustin/",
        "xUrl": "https://twitter.com/dustin"
      },
      "jobStartDate": "2020-01-01",
      "personId": 123456,
      "updateDate": "2024-01-15",
      "linkedinFollowersCount": 12500,
      "linkedinConnectionsCount": 500,
      "linkedinCertifications": [
        {
          "companyName": "Microsoft",
          "title": "Microsoft Certified: Azure Fundamentals",
          "dateYear": 2020,
          "dateMonth": 6,
          "verifyUrl": "https://www.youracclaim.com/badges/5ccf865c-dd6e-4dcc-9184-c8999d31f83d"
        }
      ],
      "linkedinCourses": [
        {
          "title": "Advanced Leadership Strategies",
          "companyName": "LinkedIn Learning"
        }
      ],
      "linkedinAwards": [
        {
          "title": "Tech Leader of the Year",
          "companyName": "Tech Awards Council",
          "dateYear": 2023,
          "summary": "Recognition for outstanding leadership in technology innovation"
        }
      ],
      "linkedinSkills": [
        "Strategic Planning",
        "Team Leadership",
        "Product Development"
      ],
      "company": {
        "name": "Lusha",
        "description": "Lusha is the sales intelligence platform designed to help businesses get their next customers.",
        "domains": {
          "homepage": "https://www.lusha.com",
          "email": "lusha.com"
        },
        "fqdn": "lusha.com",
        "location": {
          "country": "United States",
          "countryIso2": "US",
          "continent": "North America",
          "rawLocation": "Boston, MA, US",
          "city": "Boston",
          "state": "Massachusetts"
        },
        "companySize": [
          201,
          500
        ],
        "revenueRange": [
          10000000,
          50000000
        ],
        "logoUrl": "https://logo.lusha.co/logo.jpg",
        "social": {
          "linkedin": "https://linkedin.com/company/lusha",
          "crunchbase": "https://crunchbase.com/company/lusha"
        }
      }
    }
  }
}

Overview

Credits & Plans

Guides

Endpoints

Search Single Contact

Endpoint

Search Requirements

Notes:

Authorizations

Query Parameters

Response