Changelog

May 11th, 2026

• The possible input values for different company and people filters have been updated for the endpoints POST /v2/people/search and POST /v2/companies/search
  • Departments
  • Industries
  • Technologies
  • Countries and Regions

May 4th, 2026

• One Company filter was deprecated from the endpoints POST /v2/people/search and POST /v2/companies/search
  • The countries filter has been deprecated, you should use the new localities filter which allows for more in depth location searches.
  • 📝 Note: This deprecation is non-breaking — existing API integrations using the countries filter will continue to work as before.
• 13 new company filters were added to POST /v2/people/search and POST /v2/companies/search
  • The naicsCodes and naicsCodesExcluded filters allow searching by NAICS industry codes.
  • The names filter allow searching by Company names.
  • The industriesExcluded filter allows excluding specific industries.
  • The technologies, technologiesExcluded, technologyCategories, and technologyCategoriesExcluded filters allow searching by different technologies and their categories.
  • The departmentSizes filter allows search by a specific department within a specific range of employees.
  • The keywords, and keywordsExcluded filters allow searching by specific keywords.
  • The yearFounded filter allows search for companies founded within a specific time range.
  • The localities filter allows searching for companies by one or more of the following:
    • Countries and world regions.
    • Specific regions within a country.
    • Specific zip codes.
    • Free text within a company's full address.
    • Any locality filter can be set to target HQ locations only or any location.

April 29th, 2026

• 5 new ICP peoples filters were added for filters to POST /v2/recommendations/icp and GET /v2/recommendations/icp
  • The states filter allows searching with a specific region within a country.
  • The exactJobTitles filter allows searching by exact job titles without expanding to similar job titles.
  • The previousCompanyDomains filter allows searching by a person's previous companies.
  • The jobChangePeriodInDays filter allows searching for people who have recently changed jobs.
  • The excludeDepartments filters out people who are not in the list of excluded departments.
• 13 new ICP company filters were added for filters to POST /v2/recommendations/icp and GET /v2/recommendations/icp
  • The departmentSizes filter allows searching for companies having departments of a certain employee size.
  • The employeeCounts filter allows searching for companies having multiple non-consecutive employees quantities.
  • The revenues filter allows searching for companies having multiple non-consecutive revenues amounts.
  • The excludeDomains filter filters out companies with the listed excluded domains.
  • The excludeIndustries filter filters out companies with the listed excluded industries.
  • The excludeTechnologies filter filters out companies with the listed excluded technologies.
  • The includeDomains filter allows searching for companies having the specified domains.
  • The localities filter searching for companies having primary or non-primary offices in the specified countries or states.
  • The locations filter allows searching for companies having non-primary offices in the specified countries.
  • The states filter allows searching for companies having non-primary offices in the specified states.
  • The technologies filter allows searching for companies working with the specified technologies.
  • The yearFounded filter allows searching for companies founded in the specified years interval.
  • The zipCodes filter allows searching for companies having non-primary offices in the specified zip-code areas.

April 29th, 2026

• 4 new people filters were added to POST /v2/people/search
  • The states filter allows searching with a specific region within a country.
  • The exactJobTitles filter allows searching by exact job titles without expanding to similar job titles.
  • The previousCompanyDomains filter allows searching by a person's previous companies.
  • The jobChangePeriodInDays filter allows searching for people who have recently changed jobs.

April 21st, 2026

• New batch.enrichment.completed webhook event fired when all enrichments in a batch have finished. The payload includes batchID, eventType, and a data object with enrichmentID, enrichmentCallbackURL, and message.
• Recommendations: the reason.data field is now a typed object with changesAmount, currentJobTitle, and previousJobTitle instead of a generic map.

April 7th, 2026

• New recommendations endpoints to fetch company and people recommendations based on an Ideal Customer Profile (ICP):
  • POST /v2/recommendations/icp — Create or update an ICP with filters defining your target companies and people.
  • GET /v2/recommendations/icp — Retrieve saved ICP filters for the current user or a specific external user.
  • POST /v2/recommendations/fetch — Fetch daily-refreshed company and people recommendations matching your ICP.

March 19th, 2026

• The countries filter in POST /v2/companies/search now accepts world region codes (W-EMEA, W-EU, W-ME, W-AF, W-APAC, W-OC, W-AMER, W-NA, W-LATAM) in addition to ISO 3166 alpha-2 country codes.

March 12th, 2026

• New endpoint POST /v2/people/find-by-email to search for a person given their email (reverse email enrichment). Results consume search credits.
• Credits & Quotas article updated with the new search credits section.

October 6th, 2025

• Remove unused fields and add industries to GET /v2/companies/enrich/:id

September 24th, 2025

• Improved webhook security with signed signature header
• Webhook documentation updated with instructions and code samples for verifying signed signatures Secure your endpoint

August 1st, 2025

• Webhook notifications added to company enrichments POST /v2/companies/enrich
• Webhook documentation updated with the new company event here
• Better examples for GET /v2/companies/enrich/:id

July 10th, 2025

• Credits-and-quotas and index articles updated with references to the latests endpoints.
• Documented the max size for companies enrichment POST /v2/companies/enrich.

July 4th, 2025

• Added include.jobHistory flag POST /v2/people/enrich. Ask api.support@surfe.com to enable jobHistory
• Added jobHistory to GET /v2/people/enrich/:id

June 23rd, 2025

• Timeout error responses added to POST /v2/people/enrich and POST /v1/people/enrichments/bulk.

June 17th, 2025

• New endpoint to retrieve remaining credits added here: GET /v1/credits

May 6th, 2025

• Webhook article added here.
• POST /v2/people/enrich now supports webhook notifications. Check the notificationOptions.webhookUrl field.

May 29th, 2025

• Adding location and country fields to GET /v2/people/enrich/:id.

May 21st, 2025

• Added "savedSearch" field to POST /v1/people/search to support filter presets.
• Refactor and stability improvements.

April 25th, 2025

• Added POST /v2/people/enrich + LinkedInUrl enrichment support.
• Added GET /v2/people/enrich/:id.
• Removed deprecated V1 endpoints from the index.

April 14th, 2025

• Added POST /v2/companies/enrich to request company enrichments.
• Added GET /v2/companies/enrich/:id to retrieve company enrichments results.
• Updated peoplePerCompany max value to 5 and included a detailed error message. POST /v2/people/search.
• Added "mobile" to supported enrichmentType values. POST /v1/people/enrichments/bulk and POST /v1/people/enrichments.
• Removed unused endpoints from documentation.
• Removed deprecated V1 endpoints from the index.

March 31st, 2025

• Breaking changes: modified interface to /v2/people/search endpoint. Input and output payload simplified and pagination is now supported.
• Marked /v1/people/search as deprecated.
• Added a link to searchable values: industries, departments, and seniorities.
• Renamed contact to person.
• Replaced support email with api.support@surfe.com.

March 25th, 2025

• Improved 400 response for common requests: The 400 response object has been enhanced for frequently used requests. Error messages now include detailed validation failure reasons to improve debugging and troubleshooting.
• Move POST /v2/search/companies to POST /v2/companies/search.

March 21st, 2025

• Added a new endpoint for Companies Search.
• Removed beta company search /v1/organizations/search.

March 4th, 2025

• Added organization filter includeNames to people search payload. This new attribute allows filtering by company names.

January 30th, 2025

• Deprecated field companyID in people enrichment (single and bulk) and people search endpoint responses.
• Added attribute organizationIDMappings to people search payload. This new attribute helps map organization domains to existing ids so that results associated with that organization will also include this id field

January 27th, 2025

• Added field companyID in people enrichment (single and bulk) and people search endpoint responses. This is a unique identifier for the person's organization.
• Added field confidenceScore for mobile phones in people enrichment (single and bulk) endpoint responses.
• Added attribute peoplePerOrganization to people search payload. This new attribute helps define how many results to be returned per organization.

January 22th, 2025

• Deprecated field clientID in people enrichment endpoints in favor of externalID
• Deprecated request body field domains in organization's Start a bulk enrichment endpoint in favor or organizations
• Added field externalID to organization bulk enrichment endpoints

January 20th, 2025

• Improved the API documentation
• Added new endpoints to support the following services:
  • Person bulk enrichment
  • People search
  • Organization bulk enrichment
  • Organization single enrichment
  • Organizations search
  • Organizations look-alikes
• Updated Person single enrichment with new endpoint URLs and additional returned values
  • Deprecated endpoints POST /v1/enrichments and GET /v1/enrichments/:id
  • Added endpoints POST /v1/people/enrichments and GET /v1/people/enrichments/:id
  • Added the following additional fields to the enrichment response (when available):
    • Seniority
    • Company Name
    • CompanyWebsite
    • Country
    • Departments
    • Job title
    • LinkedIn URL
    • Location
    • Seniorities