Skip to main content

​
There is no hard cutover

v2 ships alongside v1. v1 keeps running in parallel and is wound down in stages, so you have a full migration window and can move at your own pace.

​
v1 deprecation timeline

v2 reached general availability on September 2, 2026 — that date is T0 below. Later milestones are indicative and subject to minor change.

​
Migration steps

1

Move to /v2 paths

Replace the /v1 prefix with /v2 on every endpoint. See the mapping below.
2

Collapse bulk calls into single endpoints

Drop the /bulk_enrich suffix. The single endpoint accepts one ID or a list of IDs, so a bulk call becomes the same endpoint with a list payload.
3

Pick sync or async

Use .../enrich for immediate results, or .../job for large runs. Async is capped at 10K input records and 24 hours per job.
4

Update renamed paths and fields

Rename contacts_information to contact_information, and update the corrected signal field names.
5

Handle removed response fields

Stop reading entity_id, display_name on business LinkedIn posts, and the address signals on company_ratings_by_employees.
6

Replace contact-availability filters

has_email and has_phone_number are removed from prospects fetch and stats. Use has_contact_details — email, phone, or email_and_phone to reproduce the old behavior, or email_or_phone for at-least-one. See Removed filters.
7

Check changed fetch defaults

Remove the size pagination parameter, and set include_operating_locations explicitly if you relied on the old default.

​
Endpoint mapping

​
Breaking changes checklist

  • /v2 path prefix applied everywhere
  • /bulk_enrich calls collapsed into /enrich or /job
  • contacts_information renamed to contact_information
  • founding_stage → funding_stage, founding_date → funding_date
  • professions_email → professional_email
  • money_spend_on_website_technologies → money_spent_on_website_technologies (webstack)
  • latest_funding_increase_in_percents → latest_funding_increase_percentage (funding_and_acquisition)
  • time_took_in_seconds → time_taken_in_seconds (response_context, every endpoint)
  • entity_id no longer read
  • display_name no longer read from business LinkedIn posts
  • Address signals no longer read from company_ratings_by_employees
  • has_email / has_phone_number replaced with has_contact_details
  • size pagination parameter removed
  • include_operating_locations set explicitly
  • Async payloads within the 10K record limit
  • Autocomplete calls pointed at /v2/autocomplete
  • Stop reading emails from contact responses — use professional_email
  • employee_joined_company → executive_joined_company in event filters, enrollments, and payload handling

What's new

The full change list

Conventions

Rules that apply across every v2 endpoint