API - Get Company Leadership Changes

Use this endpoint to retrieve leadership changes for a company, most recent month first. Leadership changes cover director-level and more senior roles and include new hires, promotions and departures.

Endpoint

POST /v2/companies/signals/leadership-change

Quota & Credits

Results from this endpoint count towards the people search quota. Each call deducts 1 search credit per 10 results returned. Credits are charged on results returned, not on the limit value.

Search credits must be enabled on your account to use this endpoint. Contact api.support@surfe.com or reach out via Zendesk to enable search credits.

Headers

{
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"
}

Request Body

{
  "filters": {
    "companyDomain": "surfe.com",
    "leadershipChange": {
      "changedSince": "2026-06-01",
      "types": [
        "new_hire",
        "promotion"
      ]
    }
  },
  "limit": 10,
  "pageToken": ""
}

Fields:

• filters.companyDomain — required. Domain or website URL of the company, as returned by company search.
• filters.leadershipChange — optional object. Which leadership changes to match, by kind and by how recent they are. An empty object is ignored.
  filters.leadershipChange.types — optional. Kinds of change to match. Omit to match all of them. This can be new_hire, promotion, or departure
• filters.leadershipChange.changedSince — optional. Only match changes dated on or after this day, as YYYY-MM-DD. Must not be in the future.
• limit — maximum number of changes per page (1–200, default 10)
• pageToken — Token to retrieve the next page of changes, taken from the previous response. Send it with the same filters.

Example Response

{
  "changeCount": 3,
  "changes": [
    {
      "date": "2026-07-01",
      "firstName": "Jane",
      "lastName": "Doe",
      "linkedinUrl": "https://www.linkedin.com/in/janedoe",
      "newCompanyDomain": "surfe.com",
      "newTitle": "VP Sales",
      "oldCompanyDomain": "starindustries.com",
      "oldTitle": "Sales Manager",
      "type": "promotion"
    }
  ],
  "domain": "surfe.com",
  "name": "Surfe",
  "nextPageToken": ""
}

Response Fields

• changeCount — total number of leadership changes for this company
• changes — list of leadership change objects, most recent first
• domain — the company domain
• name — the company name
• nextPageToken — use this to fetch the next page of results

Each change includes:

Need Help?

If you have any questions or need further assistance, reach out to our support team via Zendesk or email api.support@surfe.com.