Overview
Lusha is introducing Person API V2, bringing new features and enhanced capabilities to improve your data enrichment workflows. As part of this upgrade, Person API V1 will be deprecated to ensure a smoother, more efficient experience.
Why Is Person API V1 Being Deprecated?
The new version, Person API V2, offers significant improvements over the previous version, including:
Expanded Data Enrichment Options: With Person API V2, you can now enrich contacts not only by name + company or domain, but also using emails or LinkedIn URL. This flexibility ensures that you can work more effectively with varied datasets.
Job Change Indicator: Stay updated with real-time job changes, refreshing old contact data from marketing campaigns or outdated forms.
Richer Data Fields and Metadata: Access new company and contacts fields for deeper business insights, helping drive productivity and make more informed decisions. Person API V2 also provides detailed metadata for emails and phone numbers, including: Type (e.g., personal or business), Confidence levels for accuracy and Do Not Call (DNC) flags for compliance.
Deprecation Notice
💡 The old Person API V1 will be deprecated by January 14, 2025. Please ensure to make the necessary adjustments before this date to avoid any disruptions.
What Action Is Required?
1. Change the Endpoint URL to: (Make sure to change all calls to the new V2 endpoint.)
GET
https://api.lusha.com/v2/person
2. Adjust Request Parameters:
Person API V2 offers more input flexibility. Update your API calls to use one of the new parameter combinations (and the api_key on the header, like before):
First name + Last name + Company name / Company domain
Email
LinkedIn URL
Example of V2 Request:
GET
https://api.lusha.com/v2/person?firstName=Yoni&lastName=Tserruya&companyName=Lusha
https://api.lusha.com/v2/person?firstName=Yoni&lastName=Tserruya&companyDomain=lusha.com
https://api.lusha.com/v2/person?email=yoni@lusha.com
https://api.lusha.com/v2/person?linkedinUrl=https://www.linkedin.com/in/yonitserruya
-H api_key:API_KEY
3. Incorporate New Filtering Options:
Person API V2 allows filtering results by adding the filterBy parameter to the query:
?filterBy=phoneNumbers – Only return results with phone numbers.
?filterBy=emailAddresses – Only return results with email addresses.
Update your requests if you need to apply filters.
4. Use Refresh Job Info for Real-Time Job Updates:
If your application requires the latest job information, add the refreshJobInfo=true parameter to your requests.
Example:
GET https://api.lusha.com/v2/person?email=dustin@lusha.com&refreshJobInfo=true -H api_key:API_KEY
5. Handle Updated Response Fields: Review the new response structure and adjust your parsing logic to accommodate new fields such as:
Email metadata: emailType, emailConfidence.
Phone metadata: phoneType, doNotCall.
Company insights: revenue, funding, intent topics, and more.
6. Test the Integration with the New Version:
Ensure your code handles all response changes correctly.
Test all critical workflows to confirm the API calls succeed and return the expected
7. Deprecation Timeline Compliance:
Make sure to switch to V2 before the V1 deprecation date to avoid disruptions. Monitor logs during and after the transition for potential issues.
For more information see here the full API documentation >>