NY APIdol.ny.gov ↗
Access New York State WARN Act layoff notices (2023–2025) via API. Filter by year, company name, or location. Returns company, region, dates, and notice URL.
What is the NY API?
The NY DOL WARN Notices API exposes Worker Adjustment and Retraining Notification records from the New York State Department of Labor covering 2023 through 2025. A single endpoint, get_warn_notices, returns five fields per notice — company name, location, region, date posted, notice date, and a direct URL to the source document — with support for year filtering and full-text substring search across company and location fields.
curl -X GET 'https://api.parse.bot/scraper/98ffc000-f074-4566-9891-df6dad99ab8b/get_warn_notices?page=1&year=2023&limit=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace dol-ny-gov-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.ny_dol_warn_act_notices_api import NyWarn, Year
client = NyWarn()
# List 2024 WARN notices filtered by location
for notice in client.notices.list(year=Year.Y2024, search="New York City", limit=5):
print(notice.company_name, notice.location, notice.date_posted, notice.notice_url)
Retrieve WARN Act notices from the NY DOL legacy database. Returns company name, region, date posted, notice date, and notice URL. Supports filtering by year (2023-2025) and case-insensitive substring search against company name or location. Results are paginated client-side. As of 4/1/2025, no new notices are added to this database.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| year | string | Year of WARN notices to retrieve. Accepted values: 2023, 2024, 2025. |
| limit | integer | Maximum number of results per page. |
| search | string | Case-insensitive substring filter matching against company name or location. |
{
"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": "2025",
"limit": 5,
"total": 69,
"notices": [
{
"location": "Capital",
"notice_url": "https://dol.ny.gov/warn-plug-power-inc-region-capital-date-posted-3312025-notice-date-3252025",
"date_posted": "3/31/2025",
"notice_date": "3/25/2025",
"company_name": "Plug Power, Inc."
}
]
},
"status": "success"
}
}About the NY API
What the API returns
The get_warn_notices endpoint retrieves WARN Act notices filed with the NY Department of Labor. Each notice object in the response includes company_name, location, date_posted, notice_date, and notice_url. The notice_url links directly to the official DOL document for that filing. Coverage spans 2023, 2024, and 2025 — the three years accepted by the year parameter.
Filtering and pagination
Requests accept a year string to scope results to a specific calendar year. The search parameter performs a case-insensitive substring match against both company_name and location, making it straightforward to find all notices for a given employer or city. Results are paginated via page and limit parameters. Every response includes total, which reflects the count of matching notices after the search filter is applied, so callers can calculate page counts without an extra request.
Data scope and limitations
The API covers the NY DOL legacy WARN database for 2023–2025. Notices outside that date range are not included. Each record represents a single WARN filing; the API does not aggregate or deduplicate filings from the same employer across multiple events. The notice_date and date_posted fields are distinct — notice_date reflects when the employer submitted the notice, while date_posted reflects when it appeared in the DOL system.
The NY API is a managed, monitored endpoint for dol.ny.gov — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when dol.ny.gov changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official dol.ny.gov API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor mass layoff events in New York by polling
get_warn_noticeswith ayearfilter and checkingdate_postedfor new entries. - Build a company-specific layoff tracker by passing an employer name to the
searchparameter and collecting matchingnotice_urldocuments. - Aggregate WARN filings by region using the
locationfield to identify geographic concentrations of workforce reductions. - Cross-reference WARN notices against job listings data to detect hiring slowdowns at specific New York employers.
- Research labor market trends for a given year by retrieving all notices for 2023, 2024, or 2025 and analyzing
notice_datedistribution. - Build compliance monitoring tools that alert legal or HR teams when a company in their portfolio appears in new NY WARN filings.
| 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 | 100 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 have an official developer API for WARN notices?+
What does the `get_warn_notices` endpoint return for each notice?+
company_name, location, date_posted, notice_date, and notice_url. The notice_url points to the original DOL filing document. The response envelope also includes page, limit, total, and year to support pagination.Does the API cover WARN notices older than 2023?+
year parameter. You can fork this API on Parse and revise it to add endpoints targeting earlier years if the source makes that data available.Can I filter notices by industry, number of affected workers, or layoff type?+
company_name, location, date_posted, notice_date, and notice_url — there are no fields for industry classification, headcount, or layoff category. You can fork this API on Parse and revise it to add those fields if the underlying DOL documents expose them.How does pagination work, and how do I know how many pages exist?+
total field reflecting the number of notices matching your year and search filters. Divide total by your chosen limit value to determine the total page count, then increment the page parameter to walk through results.