dol.ny.gov APIdol.ny.gov ↗
Access New York State WARN Act layoff notices via API. Filter by year, company name, or location. Returns company, region, notice date, and notice URL.
curl -X GET 'https://api.parse.bot/scraper/98ffc000-f074-4566-9891-df6dad99ab8b/get_warn_notices?year=2025&limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Get WARN Act notices from the NY DOL. Returns company name, location (region), date posted, notice date, and notice URL. Supports filtering by year and text search by company name or location. Results are paginated.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| year | string | Year of WARN notices to retrieve (e.g. 2023, 2024, 2025). |
| limit | integer | Maximum number of results per page. |
| search | string | Search filter - matches against company name or location (case-insensitive substring match). |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"year": "string - year of data queried",
"limit": "integer - results per page",
"total": "integer - total matching notices for the given year and search filter",
"notices": "array of notice objects with company_name, location, date_posted, notice_date, notice_url"
},
"sample": {
"data": {
"page": 1,
"year": "2024",
"limit": 5,
"total": 278,
"notices": [
{
"location": "New York City",
"notice_url": "https://dol.ny.gov/warn-party-city-corporation-region-new-york-city-date-posted-12272024-notice-date-12202024",
"date_posted": "12/27/2024",
"notice_date": "12/20/2024",
"company_name": "Party City Corporation"
}
]
},
"status": "success"
}
}About the dol.ny.gov API
The NY DOL WARN Notices API exposes Worker Adjustment and Retraining Notification (WARN) Act filings from the New York State Department of Labor through a single endpoint, get_warn_notices, returning 5 fields per notice: company name, location, date posted, notice date, and a direct URL to the filing. Notices can be filtered by year and searched by company name or location substring, with full pagination support.
What the API Returns
The get_warn_notices endpoint returns an array of WARN Act notice objects, each containing company_name, location (the NY region where the layoff event is occurring), date_posted (when the notice appeared on the DOL site), notice_date (the formal WARN notice date), and notice_url (a direct link to the original filing document). Each response also includes pagination metadata: page, limit, total, and the year queried.
Filtering and Pagination
The year parameter restricts results to a specific calendar year (e.g., 2023, 2024, 2025). The search parameter performs a case-insensitive substring match against both company_name and location, so you can find all notices for a specific employer or all notices in a specific region like "Long Island" or "New York City" with a single query. Use page and limit together to paginate through large result sets — the total field tells you how many matching notices exist for your current filters.
Coverage and Scope
Data covers WARN notices filed with the New York State Department of Labor. WARN Act filings are required when employers with 50 or more employees conduct mass layoffs, plant closings, or relocations affecting a significant number of workers. The location field reflects the DOL's regional classification rather than a precise street address. Notice availability depends on what the NY DOL has published; historical coverage spans multiple years accessible via the year filter.
Official Source
The New York State Department of Labor publishes WARN notices on its public website at dol.ny.gov/warn-notices. There is no official developer API provided by the NY DOL for programmatic access to this data.
- Track layoff trends by year across New York State using the
yearfilter andtotalcount field - Monitor a specific employer for new WARN filings by searching
company_namewith thesearchparameter - Build a regional job-displacement dashboard by filtering notices by
location(e.g., "Buffalo", "Long Island") - Aggregate WARN data across multiple years to identify industries or regions with recurring mass layoffs
- Alert HR professionals or outplacement firms when new notices appear for companies in their sector
- Supply legal or compliance teams with structured WARN filing records including
notice_dateandnotice_url
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the New York State Department of Labor offer an official developer API for WARN notices?+
What does the `search` parameter match against, and is it case-sensitive?+
search parameter performs a case-insensitive substring match against both company_name and location. A search for "buffalo" will return notices where the company name or regional location contains that string, regardless of letter case.Does the API return the number of affected employees per notice?+
get_warn_notices endpoint returns company_name, location, date_posted, notice_date, and notice_url — employee count figures are not included in the response. The notice_url field links to the original filing document, which typically contains that detail. You can fork this API on Parse and revise it to add an employee count field if that data is available in the source documents.Can I retrieve notices for a specific city rather than a broad region?+
location field reflects the NY DOL's regional classification (e.g., "New York City", "Capital Region"), not a precise city or street address. Filtering by a specific city name via the search parameter will only match if that city name appears in the location string as the DOL records it. You can fork this API on Parse and revise it to add finer geographic granularity if more precise location data is available in the source.How current is the WARN notice data?+
date_posted field on each notice indicates when a filing appeared on the site. There is no real-time push; freshness depends on how recently the API was last updated relative to new DOL postings.