Changelog

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