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. Users can limit the number of records returned using the limit parameter. All the parameters are optional. 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 data in the Intellizence Layoff Dataset is available starting 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

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

Example: 2025-03-31
companyNamestringOptional

The name of the company for which the layoff data is needed. Partial name matches are supported. Mulitple values can be provided as comma separate values.

Example: FedEx
companyDomainstringOptional

The website domain of the company for which the layoff data is needed. Mulitple values can be provided as comma separate values.

Example: www.fedex.com
companyIndustrystring · enumOptional

The industry of companies for which layoff data is needed.The industries are pre-defined by Intellizence and only the values listed below will be accepted. Mulitple values can be provided as comma separate values.

Example: logistics & supply chainPossible values:
companyLocationstringOptional

The HeadQuarters location of companies for which layoff data is needed. The location can be City or State/Province or Country.

Example: Memphis,Tennessee,United States of America
companyTypestring · enumOptional

The type of companies/organizations for which layoff data is needed. The company types are pre-defined by Intellizence and only the values listed below will be accepted. Mulitple values can be provided as comma separate values.

Example: PublicPossible values:
companyTickerstringOptional

Stock ticker of the company. Mulitple values can be provided as comma separate values.

Example: FDX
layoffTypestring · enumOptional

Type of layoff/job cut. The layoff types are pre-defined by Intellizence and only the values listed below will be accepted. Mulitple values can be provided as comma separate values.

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. Mulitple values can be provided as comma separate values.

Example: Not SpecifiedPossible values:
layoffLocationstringOptional

The location of the company where layoff was announced. The location can be City or State/Province or Country.

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

application/json
post
/api/v2/dataset/layoff
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",
  "layoffReason": "Not Specified",
  "layoffLocation": "Lebanon,Tennessee,United States of America",
  "limit": 1
}
{
  "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": "",
  "id": "67eb86cebe74dd8ab4a9d1c5",
  "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"
}

Last updated