Changelog

October 6th, 2025

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

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

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

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

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.

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.

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.

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

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

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.

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