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

# New executive level hires

## Description

A **New Executive Level Hire** event tracks when a new employee is hired and officially joins an organization. This data provides insights into workforce expansion, company growth, and industry hiring trends.

**Important:** The **New executive level hires** event is limited to **new hires recorded within the last quarter**. If no employees joined the company in this period, the response will be empty.

**For a long-term hiring history,** refer to the **Workforce Trends Enrichment API**.

## Use cases:

* **Hiring Trends**: Track which industries and companies are actively growing their workforce.
* **Competitive Intelligence**: Monitor hiring activity of competitors.
* **Economic Indicators**: Assess the overall employment rate within sectors.
* **Talent Acquisition Strategy**: Identify organizations aggressively recruiting talent.

## Data Schema

**Event Name: "employee\_joined\_company" (Use this value in the event\_types parameter when querying this event.)**

| Signal                             | API Name           | Description                                                                                                                                       | Data Type |
| :--------------------------------- | :----------------- | :------------------------------------------------------------------------------------------------------------------------------------------------ | :-------- |
| Company name                       | job\_company\_name | Name of the company where employee change event occurred.                                                                                         | string    |
| Executive's current job department | job\_department    | Individual's current job department, derived from their current job title. If employee change type is 'Employee left the company', value is NULL. | string    |
| Executive's full name              | full\_name         | First and last names associated with the individual, appended with a space.                                                                       | string    |
| Executive's role change event      | change\_type       | Title of employee change event that occurred. E.g. executive joined the company.                                                                  | string    |
| Event time                         | event\_time        | The timestamp indicating when the event actually occurred                                                                                         | datetime  |
| Executive's current job title      | job\_role\_title   | Individual's current job title listed on their professional profile. If employee change type is 'Employee left the company', value is NULL.       | string    |
| Executive's LinkedIn® URL          | linkedin\_url      | URL of the individual's LinkedIn® profile.                                                                                                        | url       |
| 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/businesses/events" \
  -H "API_KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "event_types": [
    "employee_joined_company"
  ],
  "business_ids": [
    "8adce3ca1cef0c986b22310e369a0793"
  ],
  "timestamp_from": "2025-01-01T10:03:03.050Z"
}'
```

## Best Practices

* **`Filter by department (job_department)`** to track hiring trends in specific fields.
* **`Monitor job titles (job_role_title)`** to analyze demand for specialized roles.
* **`Use LinkedIn data (linkedin_url)`** to validate new hires and assess their background.

## Related Events

<Columns cols={2}>
  <Card title="Hiring (per department)" icon="users" horizontal href="/reference/businesses/events/types/hiring-by-department">
    Hiring by Department
  </Card>

  <Card title="Department trend (per department)" icon="user-plus" horizontal href="/reference/businesses/events/types/department-trend">
    Workforce Changes by Department
  </Card>
</Columns>
