Skip to content

Updates

What's changing

Retirements, breaking changes and maintenance that affect your integration now or soon, with what the API answers and what to do.

Updated . What already shipped is in the changelog.

In effect

  1. Retired
    Announced
    Retired

    Person search is retired

    POST /v2/search/persons and its available-fields route were retired on October 13, 2026. People Search replaces them.

    • POST /v2/search/personsPOST /v2/search/people
    • GET /v2/search/persons/available-fieldsGET /v2/search/people/available-fields
    The API answers
    410 Gone with the error code ENDPOINT_GONE. error.details.alternative names the endpoint to call instead. The call is not processed and costs no credits.
    What to do
    Call /v2/search/people: it returns full profiles, paginates with cursors and ships with a free count endpoint.
    Migration guide
  2. Breaking change
    Effective

    People Search drops the area filter

    /v2/search/people, /v2/search/people/count and the MCP search_persons and count_persons tools no longer accept location.area.

    • POST /v2/search/people
    • POST /v2/search/people/count
    The API answers
    422 with the error code UNKNOWN_FIELD. The request costs 0 credits.
    What to do
    Use location.city for a metropolitan area, or location.region for a state or province.
    Changelog v2.35.1

In progress

  1. Maintenance
    Deprecated
    Paused
    Back
    in a few weeks

    Company search is under maintenance

    POST /v2/search/companies and its available-fields route are paused for a few weeks. Organization search does the same job now.

    • POST /v2/search/companiesPOST /v2/search/organizations
    • GET /v2/search/companies/available-fieldsGET /v2/search/organizations/available-fields
    The API answers
    410 with the error code ENDPOINT_GONE. error.details.alternative names the endpoint to call and error.details.docs links the migration guide. The call costs no credits.
    What to do
    Move to /v2/search/organizations now. Company search comes back in a format compatible with it, so there is no second migration.
    Migration guide

Upcoming

Nothing scheduled. A change appears here before it takes effect, with its date.