API - Get Company Leadership Changes

Use this endpoint to retrieve the full list of leadership changes for a company. 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. The domain of the company whose leadership changes you want to retrieve
• filters.leadershipChange.types — optional. Filter by change type. One or more of new_hire, promotion, departure
• filters.leadershipChange.changedSince — optional. Return only changes on or after this date (YYYY-MM-DD format). Send at least one of types or changedSince
• limit — maximum number of changes per page (1–200, default 10)
• pageToken — pass the nextPageToken from the previous response to fetch the next page

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.