Skip to main content
You’re viewing the V2 (Legacy) documentation. Use the version switcher at the top of the sidebar on this tab to jump to V3 - the toggle is scoped to API docs only and won’t appear on other tabs.
Lusha is a RESTful API that lets you query verified contact and company data for prospecting, enrichment, automation, and analytics workflows. All requests are made over HTTPS and return JSON. Base URL

Authentication

All API requests require your API key passed as a request header.
Get your API key from the Lusha dashboard. Keep it secret - never expose it in client-side code or public repositories.

Rate Limiting

The API enforces 25 requests per second by default. Each response includes headers to help you track your quota: When you exceed the limit, the API returns 429 Too Many Requests. Back off and retry after the reset window.

Error Codes

API Modules

Enrichment

Add emails, phones, and firmographics to existing contact and company records.

Prospecting

Search Lusha’s database by title, seniority, location, industry, and more.

Signals

Detect job changes, promotions, and company events in real time.

Webhooks

Receive push notifications when contacts or companies trigger signal events.

Lookalikes

Find contacts and companies that match your best existing customers.

Filters

Retrieve valid filter values for prospecting searches.