Skip to content
Last updated

All notable changes to the Lusha API/MCP are documented here. We follow semantic versioning.


Current Version: 2.0.0

Status: Production • Released: 2025 • Stability: Stable

API Endpoints

Rate Limits

  • Person enrichment: 25 req/sec
  • Account usage: 5 req/min

Changelog History

## [1.3.0] - 2025-09-10 - Signals API Expansion

### Added
- **New Signals Endpoints**: Introduced 4 endpoints for contact and company signals, supporting enrichment by IDs and identifiers:
  - `POST /signals/contacts` – Retrieve contact signals by IDs
  - `POST /signals/companies` – Retrieve company signals by IDs
  - `POST /signals/contacts/search` – Retrieve contact signals by identifiers (LinkedIn URL, email, or name + company/domain)
  - `POST /signals/companies/search` – Retrieve company signals by identifiers (domain, company name, or ID)
- **Signals Filters Endpoint**:  
  - `GET /signals/filters/:objectType` – View available signal filters for `contact` or `company`  
  - `allFilters` option available to view all signals
- **Timeframe Filtering**: All signal endpoints support `start_date` (optional) with default range of last 6 months
- **Partial Profile Filter**: Added `partialProfile` boolean parameter to contact enrichment APIs for simplified contact profiles

### Changed
- **Enrichment APIs**: Expanded `v2/person` (single & bulk) and `v2/company` (single & bulk) to always return `person_id` and `company_id` where applicable
- **Signal Filters Usage**: Existing enrichment APIs can now leverage signals as filters

### Notes
- The new Signals suite allows deeper insights into contact and company activity  
- Timeframe filtering provides flexibility while defaulting to recent (6 months) signals
- Partial profiles provide a lightweight option for basic contact information retrieval

Format

## [Version] - YYYY-MM-DD

### Added
- New features and endpoints

### Changed  
- Updates to existing functionality

### Fixed
- Bug fixes and corrections

### Removed
- Deprecated features

### Security
- Security improvements

Notifications


API Versioning

VersionStatusSupport Level
2.0.xCurrentFull support
1.xLegacySecurity only

Last updated: September 2025


Last updated: August 2025


Last updated: June 2025


Last updated: December 2024