generated: '2026-08-13'
method: searched
source: https://docs.lusha.com/changelog
description: >-
  Lusha publishes a dated, semver-numbered changelog for the API and the MCP
  server on its docs site, including an explicit Added/Changed/Fixed/Removed
  template and a version-support table. Recent window captured below; the live
  page is the source of truth.
scheme: semver
current_version: 2.10.0
current_version_date: '2026-08-13'
stated_current_version: 2.9.0
stated_current_version_note: >-
  The page header says "Current Version: 2.9.0 — Released August 2026" while the
  history already lists 2.10.0 dated 2026-08-13; the header lags the history.
notifications:
  email: subscribe for release notifications (per changelog page)
  support: support@lusha.com
support_matrix:
- version: 2.9.x
  status: current
  support: full support (Tables API in beta)
- version: 2.x
  status: recent
  support: full support
- version: 1.x
  status: legacy
  support: security fixes only
entries:
- version: 2.10.0
  date: '2026-08-13'
  title: Company Social Links Expansion
  breaking: false
  additions:
  - facebook and x added to the socialLinks object on POST /v3/companies/enrich
  highlights:
  - free fields, no extra credits, available on all plans; omitted when unavailable
- version: 2.9.0
  date: '2026-08-12'
  title: Buying Group API
  breaking: true
  additions:
  - POST /v3/contacts/buying-group (operationId getContactsBuyingGroup) with persona
    roles decision_maker / potential_champion / end_user and a 0-1 relevance score
  removals:
  - Decision Makers endpoint removed, superseded by Buying Group
  highlights:
  - up to 25 companies per request; contactsLimit default 60; billed per contact via
    the buyingGroupContact action
- version: 2.8.0
  date: '2026-08-11'
  title: Signal Score API
  breaking: false
  additions:
  - POST /v3/companies/signal-score (getCompanySignalScores)
  - POST /v3/contacts/signal-score (getContactSignalScores)
  highlights:
  - new per-item codes NOT_FOUND / NO_SCORE; contacts endpoint returns a retryable
    502 on identity-resolution provider outage
- version: 2.7.0
  date: '2026-08-05'
  title: LinkedIn Activity Intent Signal
  breaking: false
  additions:
  - linkedinActivityIntent company signal type across prospecting, signals lookup and
    signal metadata
  - GET /v3/companies/signals/filters/intentCategories
  highlights:
  - startDate capped to a trailing 90-day window; maxResultsPerSignal capped at 50 per
    company; AI-generated activitySummary never contains raw post text
- version: 2.6.0
  date: '2026-07-27'
  title: Waterfall Reveal for Contact Enrichment
  breaking: false
  additions:
  - optional waterfallReveal field on POST /v3/contacts/enrich
  highlights:
  - fields resolved via waterfall are billed at the third-party provider's own credit
    rate, not a flat rate; fully opt-in and backward compatible
- version: 2.5.0
  date: '2026-07-21'
  title: Tables API
  breaking: false
  additions:
  - Contacts Tables and Companies Tables endpoint families (22 operations)
- version: 2.3.0
  date: '2026-06-02'
  title: Website Visitors API
  breaking: false
  additions:
  - POST /v3/companies/website-visits (getWebsiteVisits)
- version: 2.2.0
  date: '2026-03-10'
  title: Signal Sub-Filters, Lookalikes V3 Expansion & Doc Improvements
  breaking: false
- version: 2.1.0
  date: '2026-02-26'
  title: Contact Lookalikes V3 & Signals Rate Control
  breaking: false
- version: 1.8.0
  date: '2026-02-18'
  title: Company Data Points & News Signal Expansion
  breaking: false
- version: 1.7.0
  date: '2026-01-26'
  title: Webhooks API Release
  breaking: false
- version: 1.6.0
  date: '2025-01-05'
  title: Prospecting API Signal Filtering
  breaking: false
- version: 1.5.0
  date: '2025-10-15'
  title: Recommendations API Release
  breaking: false
  highlights:
  - the Recommendations surface is exposed through the MCP server but has no operation
    in the public v3 OpenAPI
- version: 1.4.0
  date: '2025-09-30'
  title: Enhanced Search Capabilities
  breaking: false
- version: 1.3.0
  date: '2025-09-10'
  title: Signals API Expansion
  breaking: false