Layoff Dataset API

Submit Layoff Dataset Request

post

This API endpoint allows users to access real-time and historical layoff announcement data.

Users can search data using various parameters- dateType,startDate,endDate,date,companyDomain,companyName,companyIndustry,companyLocation,companyType, companyTicker,layoffType, layoffLocation, and layoffReason.

All the parameters are optional. Users can limit the number of records returned using the limit parameter.

The API key has to be passed in HTTP header with the name x-api-key.

Header parameters

x-api-keystringRequired

Intellizence API key for authenticating the request.

Body

dateTypestring · enumOptional

Choose the date type used to filter records.The default value is 'ANNOUNCED'. To get the daily update of records created or modified, 'LAST-MODIFIED' is recommended.

Example: ANNOUNCEDPossible values:

startDatestring · dateOptional

The start date (YYYY-MM-DD) from which layoff data is needed. The Intellizence Layoff Dataset contains data beginning from 2020-01-01.

Example: 2025-03-31

endDatestring · dateOptional

The end date (YYYY-MM-DD) up to which layoff data is needed.

Example: 2025-03-31

datestring · dateOptional

Exact date (YYYY-MM-DD) for which the layoff data is needed.

Example: 2025-03-31

companyNamestringOptional

Name(s) of the company for which layoff data is needed.Partial name matching is supported.Multiple values can be provided either as a comma-separated string or as an array.

Example: FedEX

companyDomainstringOptional

The website domain(s) of the company for which the layoff data is needed. Partial domain matching is supported. Multiple values can be provided either as a comma-separated string or as an array.

Example: www.fedex.com

companyIndustrystring · enumOptional

The industry or industries of the companies for which layoff data is requested. Industries are predefined by Intellizence, and only the values listed below are supported. Multiple values can be provided as an array.

Example: logistics & supply chainPossible values:

companyLocationstringOptional

The location of the company headquarters for which layoff data is needed. The location can be specified as a city, state/province, or country. Multiple values can be provided either as a comma-separated string or as an array.

Example: Memphis,Tennessee,United States of America

companyTypestring · enumOptional

The type of company or organization for which layoff data is needed. The company types are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values can be provided either as a comma-separated string or as an array.

Example: PublicPossible values:

companyTickerstringOptional

Stock ticker of the company

Example: FDX

layoffTypestring · enumOptional

The type of layoff/job cut. The layoff types are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values can be provided either as a comma-separated string or as an array.

Example: Downsizing/LayoffPossible values:

layoffReasonstring · enumOptional

Layoff reason mentioned in the source. The layoff reasons are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values can be provided either as a comma-separated string or as an array.

Example: Not SpecifiedPossible values:

layoffLocationstringOptional

The location of the company where layoff was announced. The location can be city or state/province or country. Multiple values can be provided either as a comma-separated string or as an array.

Example: Lebanon,Tennessee,United States of America

limitintegerOptional

The maximum number of records to be returned.

Example: 1

Responses

200

Successful response, returns the Layoff dataset record(s)

application/json

400

Bad request, possibly missing required parameters, invalid data, invalid or missing API key

404

Available credits are 0

405

Insufficient credits

500

Internal server error

post

HTTPcURLJavaScriptPython

POST /api/v2/dataset/layoff HTTP/1.1
Host: api.intellizence.com
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 435

{
  "dateType": "ANNOUNCED",
  "startDate": "2025-03-31",
  "endDate": "2025-03-31",
  "date": "2025-03-31",
  "companyName": "FedEx",
  "companyDomain": "www.fedex.com",
  "companyIndustry": "logistics & supply chain",
  "companyLocation": "Memphis,Tennessee,United States of America",
  "companyType": "Public",
  "companyTicker": "FDX",
  "layoffType": "Downsizing/Layoff",
  "layoffLocation": "Lebanon,Tennessee,United States of America",
  "layoffReason": "Not Specified",
  "limit": 1
}

Example 1 - All ParametersExample 2 - By Company IndustriesExample 3 - By Company HQ LocationsExample 4 - By Company Type

{
  "id": "67eb86cebe74dd8ab4a9d1c5",
  "announcedDate": "2025-03-31",
  "company": {
    "name": "FedEx",
    "domain": "www.fedex.com",
    "industries": [
      "logistics & supply chain"
    ],
    "location": "Memphis,Tennessee,United States of America",
    "type": "Public",
    "ticker": [
      "FDX"
    ],
    "stockExchange": [
      "NYSE"
    ]
  },
  "count": 1,
  "location": {
    "country": "United States of America",
    "state": "Tennessee",
    "city": "Lebanon"
  },
  "layoffType": "Downsizing/Layoff",
  "layoffReason": "Not Specified",
  "businessDivision": "text",
  "sourceType": "WARN Filings",
  "lastModified": "2025-03-06",
  "title": "WARN Filings - March 2025",
  "url": "https://www.tn.gov/content/dam/tn/workforce/documents/majorpublications/reports-02/FedEx-TDLWD-WARN-LETTER.pdf"
}