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.
Endpoint
POST https://connect.intellizence.com/api/dataset/executive-changeAuthentication
Include your API key in the request header.
x-api-key: YOUR_API_KEYContent Type
Content-Type: application/jsonSample 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
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
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
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
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
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
7. Search by Executive Name
Use executiveName to retrieve C-Suite change records for a specific executive.
Request Body
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
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
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
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
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-DDformat.The Intellizence C-Suite Changes Dataset contains data beginning from
2021-01-01.Use
LAST-MODIFIEDwhen you want newly added or updated records.Use
ANNOUNCEDwhen you want records based on the executive change announcement date.Use
companyDomainfor CRM matching, account enrichment, account monitoring, and workflow automation.Use
companyNamefor manual lookup when the company domain is not available.Use
companyTickerfor public company monitoring.Use
executiveNameto search for a specific executive.Use
executiveTitleto search by exact or near-exact job title.Use
executiveTitleCategoryfor standardized role-category filtering.Use
reasonto filter by change type, such as new appointment, promotion, resignation, retirement, termination, or other leadership changes.
Last updated