Ctrlk

Intellizence C-Suite Changes API Sample Requests

Sample requests for the Intellizence C-Suite Changes API, including filters for date, company domain, industry, company location, company type, ticker, executive name, executive title, executive title

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.

All request parameters are optional. You can use a single filter or combine multiple filters based on your use case.

Endpoint

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

Authentication

Include your API key in the request header.

x-api-key: YOUR_API_KEY

Content Type

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

cURL Example

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

cURL Example

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

cURL Example

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

cURL Example

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

cURL Example

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

cURL Example

7. Search by Executive Name

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

Request Body

cURL Example

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

cURL Example

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

cURL Example

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

cURL Example

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

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

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

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

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

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.

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.

Use ticker for public company monitoring

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

Use executive title category for role-based filtering

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

Use executive title for exact title search

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

Use reason to classify leadership changes

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

Use LAST-MODIFIED for daily syncs

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

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.

Use limit to control result size

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

Combine filters for more precise results

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

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.

PreviousIntellizence C-Suite Changes Signals APINextIntellizence Data & Security Breaches Signals API

Last updated