Changelog

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