> ## Documentation Index
> Fetch the complete documentation index at: https://developers.explorium.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Employee changed role

## 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.)**

| Signal | API Name | Description | Data Type |
| :- | :- | :- | :- |
| previous\_job\_title | Employee's previous job title | Individual's previous job title listed on their professional profile. | string |
| event\_time | Event time | The timestamp indicating when the event actually occurred | datetime |
| current\_job\_title | Employee's current job title | Individual's current job title listed on their professional profile. | string |
| current\_company\_name | Employee's current workplace | Name of the company where the individual currently works. | string |
| current\_company\_id | Current workplace entity ID | Explorium's 32 character unique entity ID associated with the individual's current workplace. | string |
| previous\_company\_name | Employee's previous workplace | Name of the company where the individual previously worked. | string |
| previous\_company\_id | Previous workplace entity ID | Explorium's 32 character unique entity ID associated with the individual's previous workplace. | string |
| event\_name | Event name | Name of the event related to employee's role change. | string |

## Query Example

```curl cURL theme={null}
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.

## Related Events

* [Recently changed company](/reference/prospects/events/types/recently_changed_company) - Identifies when an employee transitions to a new company.
* [Employee's workplace anniversary](/reference/prospects/events/types/employee_workplace_anniversary) - Marks the annual anniversary of an employee’s start date at their current company.