> For the complete documentation index, see [llms.txt](https://docs.intellizence.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intellizence.com/signals-api/c-suite-changes/sample-requests.md).

# Intellizence C-Suite Changes API Sample Requests

## C-Suite Changes API Sample Requests

Use these sample API requests to retrieve executive appointments, departures, promotions, retirements, resignations, and other leadership change records from the Intellizence C-Suite Changes Dataset.

These examples show common ways to filter C-Suite change records by date, company domain, industry, company location, company type, ticker, executive name, executive title, executive title category, reason, and limit.

{% hint style="info" %}
All request parameters are optional. You can use a single filter or combine multiple filters based on your use case.
{% endhint %}

***

### Endpoint

```http
POST https://connect.intellizence.com/api/dataset/executive-change
```

### Authentication

Include your API key in the request header.

```http
x-api-key: YOUR_API_KEY
```

### Content Type

```http
Content-Type: application/json
```

***

## Sample API Requests

### 1. Get Daily Updated Records

Use `dateType: "LAST-MODIFIED"` to retrieve records that were created or updated on a specific date.

This is recommended for daily syncs, alerts, enrichment workflows, and automated data pipelines.

#### Request Body

```json
{
  "dateType": "LAST-MODIFIED",
  "date": "2025-05-03",
  "limit": 5
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/executive-change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dateType": "LAST-MODIFIED",
    "date": "2025-05-03",
    "limit": 5
  }'
```

***

### 2. Get C-Suite Changes Announced on a Specific Date

Use `dateType: "ANNOUNCED"` and `date` to retrieve C-Suite change records announced on a specific date.

#### Request Body

```json
{
  "dateType": "ANNOUNCED",
  "date": "2025-05-03",
  "limit": 10
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/executive-change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dateType": "ANNOUNCED",
    "date": "2025-05-03",
    "limit": 10
  }'
```

***

### 3. Get C-Suite Changes Within a Date Range

Use `startDate` and `endDate` to retrieve executive change records announced during a specific period.

The Intellizence C-Suite Changes Dataset contains data beginning from `2021-01-01`.

#### Request Body

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-05-01",
  "endDate": "2025-05-31",
  "limit": 25
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/executive-change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dateType": "ANNOUNCED",
    "startDate": "2025-05-01",
    "endDate": "2025-05-31",
    "limit": 25
  }'
```

***

### 4. Search by Company Domain

Use `companyDomain` to retrieve C-Suite change records for a specific company website domain.

This is recommended for CRM enrichment, account matching, account monitoring, data pipelines, and workflow automation because domains are usually more precise than company names.

#### Request Body

```json
{
  "companyDomain": "berkshirehathaway.com",
  "limit": 10
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/executive-change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyDomain": "berkshirehathaway.com",
    "limit": 10
  }'
```

***

### 5. Search by Executive Title Category

Use `executiveTitleCategory` to retrieve executive changes by leadership function or role category.

Examples include `Chief Executive Officer ( CEO)/President/Managing Director`, `Chief Financial Officer ( CFO) / Head of Finance`, `Chief Operating Officer ( COO)`, `Chief Technology Officer ( CTO)`, `Chief Marketing Officer ( CMO)`, `Chief Revenue Officer ( CRO) / Head of Sales`, `Chief Information Security Officer ( CISO)"`, and `Board of Director`.

#### Request Body

```json
{
  "executiveTitleCategory": [
    "Chief Executive Officer ( CEO)/President/Managing Director",
    "Chief Financial Officer ( CFO) / Head of Finance"
  ],
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/executive-change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "executiveTitleCategory": [
      "Chief Executive Officer ( CEO)/President/Managing Director",
      "Chief Financial Officer ( CFO) / Head of Finance"
    ],
    "limit": 20
  }'
```

***

### 6. Search by Executive Title

Use `executiveTitle` to retrieve records for a specific executive title.

This is useful when you want to search for exact or near-exact role titles such as Chief Executive Officer, Chief Financial Officer, Chief Operating Officer, Chief Technology Officer, or Chief Revenue Officer.

#### Request Body

```json
{
  "executiveTitle": "Chief Executive Officer",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/executive-change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "executiveTitle": "Chief Executive Officer",
    "limit": 20
  }'
```

***

### 7. Search by Executive Name

Use `executiveName` to retrieve C-Suite change records for a specific executive.

#### Request Body

```json
{
  "executiveName": "Greg Abel",
  "limit": 10
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/executive-change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "executiveName": "Greg Abel",
    "limit": 10
  }'
```

***

### 8. Search by Reason

Use `reason` to retrieve executive changes by change reason.

Examples include `New Appointment`, `Promoted/Role Change`, `Retired`, `Terminated`, `Health`, `Resigned`, `Demise`, and `Others`.

#### Request Body

```json
{
  "reason": [
    "New Appointment",
    "Promoted/Role Change"
  ],
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/executive-change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "reason": [
      "New Appointment",
      "Promoted/Role Change"
    ],
    "limit": 20
  }'
```

***

### 9. Search by Company Industry

Use `companyIndustry` to retrieve C-Suite changes for companies in one or more industries.

This is useful for sector monitoring, executive movement analysis, investment research, sales intelligence, and competitive intelligence.

#### Request Body

```json
{
  "companyIndustry": [
    "technology",
    "financial services"
  ],
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/executive-change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyIndustry": [
      "technology",
      "financial services"
    ],
    "limit": 20
  }'
```

***

### 10. Use Multiple Filters Together

Combine filters to narrow results by date range, company type, industry, executive title category, reason, and company location.

#### Request Body

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-05-31",
  "companyIndustry": [
    "technology"
  ],
  "companyType": [
    "Public"
  ],
  "executiveTitleCategory": [
    "Chief Executive Officer ( CEO)/President/Managing Director",
    "Chief Financial Officer ( CFO) / Head of Finance"
  ],
  "reason": [
    "New Appointment",
    "Promoted/Role Change"
  ],
  "companyLocation": "United States of America",
  "limit": 50
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/executive-change \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dateType": "ANNOUNCED",
    "startDate": "2025-01-01",
    "endDate": "2025-05-31",
    "companyIndustry": [
      "technology"
    ],
    "companyType": [
      "Public"
    ],
    "executiveTitleCategory": [
      "Chief Executive Officer ( CEO)/President/Managing Director",
      "Chief Financial Officer ( CFO) / Head of Finance"
    ],
    "reason": [
      "New Appointment",
      "Promoted/Role Change"
    ],
    "companyLocation": "United States of America",
    "limit": 50
  }'
```

***

## Use Case Examples

### 1. Daily Data Sync

Use this example when you want to pull newly added or updated C-Suite change records into your application, database, CRM, dashboard, or analytics workflow.

#### Recommended Filters

```json
{
  "dateType": "LAST-MODIFIED",
  "date": "2025-05-03",
  "limit": 100
}
```

#### Best For

* Data pipelines
* Daily refreshes
* Internal dashboards
* Alerts and workflow automation
* CRM and data warehouse enrichment

***

### 2. CRM or Account Enrichment

Use this example to check whether a company in your CRM has recent leadership changes.

#### Recommended Filters

```json
{
  "companyDomain": "berkshirehathaway.com",
  "dateType": "LAST-MODIFIED",
  "startDate": "2025-01-01",
  "endDate": "2025-05-31",
  "limit": 10
}
```

#### Best For

* CRM enrichment
* Account scoring
* Sales intelligence
* Customer intelligence
* Signal-based selling workflows

***

### 3. Sales and Prospecting

Use this example to identify accounts with new executives, role changes, or leadership transitions that may create new buying windows.

#### Recommended Filters

```json
{
  "dateType": "LAST-MODIFIED",
  "startDate": "2025-01-01",
  "endDate": "2025-05-31",
  "companyIndustry": [
    "technology"
  ],
  "executiveTitleCategory": [
    "Chief Executive Officer ( CEO)/President/Managing Director",
    "Chief Revenue Officer ( CRO) / Head of Sales",
    "Chief Marketing Officer ( CMO)"
  ],
  "reason": [
    "New Appointment",
    "Promoted/Role Change"
  ],
  "limit": 25
}
```

#### Best For

* Prospecting
* Account prioritization
* Trigger-based outreach
* Sales and marketing campaigns
* Go-to-market workflows

***

### 4. Executive Search and Talent Intelligence

Use this example to monitor senior leadership changes by role category, industry, and geography.

#### Recommended Filters

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-12-31",
  "companyIndustry": [
    "healthcare",
    "technology"
  ],
  "executiveTitleCategory": [
    "Chief Executive Officer ( CEO)/President/Managing Director",
    "Chief Financial Officer ( CFO) / Head of Finance",
    "Chief Operating Officer ( COO)"
  ],
  "companyLocation": "United States of America",
  "limit": 50
}
```

#### Best For

* Executive search
* Leadership intelligence
* Talent market mapping
* Mandate discovery
* Board and senior leadership tracking

***

### 5. Risk and Customer Success Monitoring

Use this example to identify leadership exits, resignations, retirements, or executive changes that may signal account risk, strategic change, or organizational uncertainty.

#### Recommended Filters

```json
{
  "dateType": "LAST-MODIFIED",
  "startDate": "2025-01-01",
  "endDate": "2025-05-31",
  "reason": [
    "Resigned",
    "Retired",
    "Terminated"
  ],
  "executiveTitleCategory": [
    "Chief Executive Officer ( CEO)/President/Managing Director",
    "Chief Financial Officer ( CFO) / Head of Finance",
    "Chief Operating Officer ( COO)"
  ],
  "limit": 25
}
```

#### Best For

* Customer risk monitoring
* Renewal risk detection
* Account health scoring
* Vendor reassessment signals
* Strategic change monitoring

***

## Recommended Use Cases

| Use Case                                 | Recommended Filters                                                        |
| ---------------------------------------- | -------------------------------------------------------------------------- |
| Daily data sync                          | `dateType`, `date`, `limit`                                                |
| CRM or account enrichment                | `companyDomain`, `dateType`, `startDate`, `endDate`                        |
| Sales and prospecting                    | `companyIndustry`, `executiveTitleCategory`, `reason`, date range          |
| Executive search and talent intelligence | `executiveTitleCategory`, `companyIndustry`, `companyLocation`, date range |
| Risk and customer success monitoring     | `reason`, `executiveTitleCategory`, date range                             |

***

## Best Practices

### Prefer company domain for company matching

For CRM enrichment, data pipelines, account matching, and automated workflows, use `companyDomain` when available.

Company domains are usually more precise than company names and help reduce duplicate or ambiguous matches.

```json
{
  "companyDomain": "berkshirehathaway.com",
  "limit": 10
}
```

### Use company name for manual lookup

You can also use `companyName` to search for C-Suite change records by company name.

Company name search is useful for manual lookup, but for automated workflows, CRM enrichment, and account matching, use `companyDomain` when available.

```json
{
  "companyName": "Berkshire Hathaway",
  "limit": 10
}
```

### Use ticker for public company monitoring

For public companies, use `companyTicker` when you want to search by stock ticker.

```json
{
  "companyTicker": "BRK.A",
  "limit": 10
}
```

### Use executive title category for role-based filtering

Use `executiveTitleCategory` when you want to filter by standardized leadership role categories.

```json
{
  "executiveTitleCategory": [
    "Chief Executive Officer ( CEO)/President/Managing Director",
    "Chief Financial Officer ( CFO) / Head of Finance"
  ],
  "limit": 25
}
```

### Use executive title for exact title search

Use `executiveTitle` when you want to search for a specific executive title.

```json
{
  "executiveTitle": "Chief Executive Officer",
  "limit": 25
}
```

### Use reason to classify leadership changes

Use `reason` to filter by the reason for the executive change.

```json
{
  "reason": [
    "New Appointment",
    "Promoted/Role Change",
    "Resigned"
  ],
  "limit": 25
}
```

### Use `LAST-MODIFIED` for daily syncs

For recurring syncs, alerts, and automated workflows, use `LAST-MODIFIED`.

```json
{
  "dateType": "LAST-MODIFIED",
  "date": "2025-05-03"
}
```

This helps retrieve records that were newly added or updated on that date.

### Use `ANNOUNCED` for event-date research

For research based on when a C-Suite change was announced, use `ANNOUNCED`.

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-05-31"
}
```

### Use `limit` to control result size

The default limit is `100` records if no limit is provided.

```json
{
  "limit": 100
}
```

### Combine filters for more precise results

You can combine multiple filters in a single request to narrow your results.

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-05-31",
  "companyIndustry": [
    "technology"
  ],
  "executiveTitleCategory": [
    "Chief Executive Officer ( CEO)/President/Managing Director"
  ],
  "reason": [
    "New Appointment"
  ],
  "companyLocation": "United States of America",
  "limit": 50
}
```

***

## Notes

* All parameters are optional.
* Dates should be provided in `YYYY-MM-DD` format.
* The Intellizence C-Suite Changes Dataset contains data beginning from `2021-01-01`.
* Use `LAST-MODIFIED` when you want newly added or updated records.
* Use `ANNOUNCED` when you want records based on the executive change announcement date.
* Use `companyDomain` for CRM matching, account enrichment, account monitoring, and workflow automation.
* Use `companyName` for manual lookup when the company domain is not available.
* Use `companyTicker` for public company monitoring.
* Use `executiveName` to search for a specific executive.
* Use `executiveTitle` to search by exact or near-exact job title.
* Use `executiveTitleCategory` for standardized role-category filtering.
* Use `reason` to filter by change type, such as new appointment, promotion, resignation, retirement, termination, or other leadership changes.