Skip to main content

Person API V2

What's new in Person API V2 and how to migrate your requests from V1, including the updated endpoint and metadata parameter changes.

Written by Ella
Updated over a week ago

Person API V2 expands what you can look up via the Lusha API. In addition to the original name + company/domain lookup, V2 lets you enrich contact records using just an email address or a LinkedIn URL.

Migrating from V1 to V2

Update your request endpoint from:

api.lusha.com/bulk/person

To:

api.lusha.com/v2/person

⚠️ Important: The API filters have moved to a new object called metadata. Update your requests as follows:

  • Change filters.property β†’ metadata.filterBy

Before: filters.property

After: metadata.filterBy

Keeping job information current

To automatically refresh a contact's job information when they change roles, include the refreshJobInfo parameter in your API call. This applies when searching by email or by name.

For full API documentation, visit the Lusha API Hub.

Did this answer your question?