Skip to main content

​
Description

An Employee Changed Role event tracks when an individual transitions into a new job or role. This data provides insights into career progressions, role changes, and leadership movement. The role change could occur at the same workplace they were previously or at a new one. Important: The Employee Job Changes event tracks only recent position changes within the last quarter (timestamp_from should be set to the past 3 months). If no employee changed jobs within the specified timeframe, no data will be returned. For a historical view of workforce changes, use the Professional profile contact and workplace Enrichment API.

​
Use cases:

  • Talent Intelligence: Identify professionals moving into leadership positions.
  • Sales & Outreach: Target prospects who recently changed roles for timely engagement.
  • Competitive Insights: Track how key personnel shifts affect businesses.
  • Recruitment Strategy: Monitor role changes for hiring opportunities.

​
Data Schema

Event Name: “prospect_changed_role” (Use this value in the event_types parameter when querying this event.)
SignalAPI NameDescriptionData Type
previous_job_titleEmployee’s previous job titleIndividual’s previous job title listed on their professional profile.string
event_timeEvent timeThe timestamp indicating when the event actually occurreddatetime
current_job_titleEmployee’s current job titleIndividual’s current job title listed on their professional profile.string
current_company_nameEmployee’s current workplaceName of the company where the individual currently works.string
current_company_idCurrent workplace entity IDExplorium’s 32 character unique entity ID associated with the individual’s current workplace.string
previous_company_nameEmployee’s previous workplaceName of the company where the individual previously worked.string
previous_company_idPrevious workplace entity IDExplorium’s 32 character unique entity ID associated with the individual’s previous workplace.string
event_nameEvent nameName of the event related to employee’s role change.string

​
Query Example

cURL
curl -X POST \
  "https://api.explorium.ai/v1/prospects/events" \
  -H "API_KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "event_types": [
    "prospect_changed_role"
  ],
  "prospect_ids": [
    "20ae6cbf564ee683e66685e429844a5ff8ffc30f"
  ],
  "timestamp_from": "2024-01-01T10:03:03.050Z"
}'

​
Best Practices

  • Filter by company (current_company_name) to track role changes within target organizations.
  • Monitor title progression (current_job_title) to identify career advancements.
  • Use timestamps (event_time) to act on timely job changes.
⌘I