Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Intellizence Layoffs API Sample Requests

Sample requests for the Intellizence Layoffs API, including filters for date, company domain, industry, company location, layoff location, company type, ticker, layoff type, layoff reason, and limit.

Layoffs API Sample Requests

Use these sample API requests to retrieve layoff, downsizing, workforce reduction, plant closure, furlough, and job cut records from the Intellizence Layoffs Dataset.

These examples show common ways to filter layoff records by date, company domain, industry, company location, layoff location, company type, ticker, layoff type, layoff 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/layoff

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 Layoffs Announced on a Specific Date

Use dateType: "ANNOUNCED" and date to retrieve layoff records announced on a specific date.

Request Body

cURL Example

3. Get Layoffs Within a Date Range

Use startDate and endDate to retrieve layoffs announced during a specific period.

The Intellizence Layoffs Dataset contains data beginning from 2020-01-01.

Request Body

cURL Example

4. Search by Company Domain

Use companyDomain to retrieve layoff records for a specific company website domain.

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

Request Body

cURL Example

5. Search by Company Industry

Use companyIndustry to retrieve layoff records for companies in one or more industries.

This is useful for market research, sector monitoring, risk analysis, workforce trend analysis, and investment research.

Request Body

cURL Example

6. Search by Company Location

Use companyLocation to find layoff records for companies headquartered in a specific city, state, province, country, or region.

Request Body

cURL Example

7. Search by Layoff Location

Use layoffLocation to find layoff events announced for a specific location.

This is useful when you want to track workforce reductions by plant, office, city, state, province, country, or region.

Request Body

cURL Example

8. Search by Layoff Type

Use layoffType to retrieve layoffs by event type.

Examples include Downsizing/Layoff, Furlough/Temporary, Hiring Freeze, Permanent Plant Closure, Temporary Plant Closure, Voluntary Retirement, Voluntary Separation Program, and Other.

Request Body

cURL Example

9. Search by Layoff Reason

Use layoffReason to retrieve layoffs by the reason mentioned in the source.

Examples include Restructuring, Cost-cutting, M&A, Automation, Business Closure, Relocation, Bankruptcy, Financial Distress, AI Automation, and Not Specified.

Request Body

cURL Example

10. Use Multiple Filters Together

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

Request Body

cURL Example

Use Case Examples

1. Daily Data Sync

Use this example when you want to pull newly added or updated layoff 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 Risk Enrichment

Use this example to check whether a company in your CRM has recent layoff activity.

Recommended Filters

Best For

  • CRM enrichment

  • Account risk scoring

  • Customer health monitoring

  • Sales and customer success workflows

  • Renewal and churn risk monitoring

3. Sector Workforce Trend Analysis

Use this example to track layoff activity across a specific industry.

Recommended Filters

Best For

  • Workforce trend analysis

  • Market research

  • Sector monitoring

  • Investment research

  • Competitive intelligence

4. WARN and Plant Closure Monitoring

Use this example to monitor plant closures, facility shutdowns, and location-specific workforce reductions.

Recommended Filters

Best For

  • WARN notice monitoring

  • Plant closure tracking

  • Economic development research

  • Supply chain risk monitoring

  • Location-based workforce analysis

5. Sales and Customer Success Monitoring

Use this example to identify accounts going through restructuring, cost-cutting, or workforce reductions.

Recommended Filters

Best For

  • Account prioritization

  • Customer risk monitoring

  • Renewal risk detection

  • Signal-based outreach

  • Churn and downsell risk workflows

Recommended Use Cases

Use Case
Recommended Filters

Daily data sync

dateType, date, limit

CRM or account risk enrichment

companyDomain, dateType, startDate, endDate

Sector workforce trend analysis

companyIndustry, date range, limit

WARN and plant closure monitoring

layoffType, layoffLocation, date range

Sales and customer success monitoring

companyIndustry, layoffReason, 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 layoff 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 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 layoff was announced, use ANNOUNCED.

Use company location for headquarters-based analysis

Use companyLocation when you want to filter by where the company is headquartered.

Use layoff location for event-location analysis

Use layoffLocation when you want to filter by where the layoff, closure, or workforce reduction occurred.

Use layoff type to classify workforce events

Use layoffType to distinguish between layoffs, furloughs, hiring freezes, plant closures, and voluntary separation programs.

Use layoff reason for risk and trend analysis

Use layoffReason to analyze why workforce reductions are happening.

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 Layoffs Dataset contains data beginning from 2020-01-01.

  • Use LAST-MODIFIED when you want newly added or updated records.

  • Use ANNOUNCED when you want records based on the layoff announcement date.

  • Use companyDomain for CRM matching, account enrichment, risk monitoring, and workflow automation.

  • Use companyName for manual lookup when the company domain is not available.

  • Use companyTicker for public company monitoring.

  • Use companyLocation for headquarters-based filtering.

  • Use layoffLocation for event-location filtering.

  • Use layoffType to filter by workforce event type.

  • Use layoffReason to filter by the reason mentioned in the source.

PreviousIntellizence Layoffs Signals API
NextIntellizence Business Expansion & Major Hiring Signals API

Last updated