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