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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.intellizence.com/signals-api/c-suite-changes/sample-requests.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.