---
title: "Query WARN layoff/closure notices"
method: GET
path: "/api/v1/warn/notices"
tags: ["warn"]
---

# Query WARN layoff/closure notices

`GET /api/v1/warn/notices`

## Request

- Base URL: `https://api.tppflow.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tppflow.com/api/v1/warn/notices`
- Auth: none declared

## Query parameters

- `state` string, nullable: 2-letter state filter, e.g. CA
- `company` string, nullable: Case-insensitive substring on company name
- `start_date` string, nullable: effective_date >= YYYY-MM-DD
- `end_date` string, nullable: effective_date <= YYYY-MM-DD
- `location` string, nullable: Case-insensitive substring on county/location
- `limit` integer
- `offset` integer

## Headers

- `X-RapidAPI-Proxy-Secret` string, nullable
- `authorization` string, nullable
- `X-API-Key` string, nullable

## Response `200`

Successful Response

- NoticesResponse
  - `count` integer, required
  - `query` object, required
  - `notices` Notice[], required
    - `state` string, required: USPS 2-letter state code
    - `company_name` string, nullable
    - `employees_impacted` integer, nullable
    - `effective_date` string, nullable: ISO date the layoff/closure takes effect
    - `notice_date` string, nullable: ISO date the WARN notice was filed (lead-time signal)
    - `location` string, nullable: County-level location
    - `layoff_type` string, nullable
    - `raw_source_file` string, required: Stable provenance key for the source artifact

## Other responses

- `402`: Payment required -- no gateway wristband and no valid capability token. Body carries the checkout URL.
- `403`: Key is valid but scoped to a different module
- `422`: Validation Error

---

[API](https://skmtc.dev/tppflow/apis/teos-transmuter-tollbooth.md) · [All operations](https://skmtc.dev/tppflow/apis/teos-transmuter-tollbooth/llms.txt) · [OpenAPI document](https://skmtc.dev/tppflow/apis/teos-transmuter-tollbooth/revisions/9cc882993c5a?raw)