> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Quiver Quantitative API: base URL https://api.quiverquant.com, endpoints under /beta/. Authenticate every request with the header `Authorization: Bearer <API key>`. Keys are on https://api.quiverquant.com/dashboard/ after subscribing at https://api.quiverquant.com/pricing/.
> AI agents can use the Quiver MCP server at https://mcp.quiverquant.com/ (streamable HTTP; OAuth sign-in, or the API key as a Bearer token). Setup: https://api.quiverquant.com/docs/mcp-server.
> Each dataset needs a plan (https://api.quiverquant.com/docs/plans-and-access) and each endpoint has a per-account rate limit (https://api.quiverquant.com/docs/rate-limits).

# WARN Notices (Layoffs)

> Returns WARN Act notices (advance notice of mass layoffs and plant closures that employers must file with states) for publicly traded companies, newest first. Each row is one notice, with the employer, location, number of employees affected, and notice and effective dates. `FirstSeen` is when Quiver first collected the notice, for point-in-time use. Optional `ticker` filters to one company, `state` to one state (two-letter code), and `date_from` / `date_to` (YYYYMMDD) bound the notice date; results are paginated via `page` (1-based) and `page_size` (default and max 1000).

**Plan:** Trader or above. A Hobbyist plan gets a `403` from this endpoint. See [Plans and data access](/docs/plans-and-access.md).


## OpenAPI

````yaml /openapi.json get /beta/live/warnnotices
openapi: 3.0.3
info:
  title: Quiver API
  version: v1
  description: Tap into the power of alternative data
  contact:
    name: 'Us: info@quiverquant.com'
    email: info@quiverquant.com
  license:
    name: Terms of Service
    url: https://www.quiverquant.com/termsofservice/
servers:
  - url: https://api.quiverquant.com
security: []
tags:
  - name: Congress
    description: Stock trades, holdings and profiles of members of Congress.
  - name: Trump trades
    description: Stock trades by Donald Trump.
  - name: Insiders and institutions
    description: Insider trades, 13F holdings, shareholders and executive pay.
  - name: Government contracts
    description: Federal contracts awarded to public companies.
  - name: Lobbying and donations
    description: Corporate lobbying, revolving door lobbyists and PAC donations.
  - name: Market data
    description: Daily prices, off-exchange trading and Polymarket trades.
  - name: Patents
    description: Patents granted to public companies, and patent-based signals.
  - name: Company data
    description: Layoff notices, app ratings and the Quiver newsfeed.
  - name: New Constructs
    description: New Constructs ratings, a separate subscription.
paths:
  /beta/live/warnnotices:
    get:
      tags:
        - Company data
      summary: WARN Notices (Layoffs)
      description: >-
        Returns WARN Act notices (advance notice of mass layoffs and plant
        closures that employers must file with states) for publicly traded
        companies, newest first. Each row is one notice, with the employer,
        location, number of employees affected, and notice and effective dates.
        `FirstSeen` is when Quiver first collected the notice, for point-in-time
        use. Optional `ticker` filters to one company, `state` to one state
        (two-letter code), and `date_from` / `date_to` (YYYYMMDD) bound the
        notice date; results are paginated via `page` (1-based) and `page_size`
        (default and max 1000).
      operationId: live_warnnotices_retrieve
      parameters:
        - in: query
          name: date_from
          schema:
            type: string
            format: date
          description: Date to query from in YYYYMMDD format
        - in: query
          name: date_to
          schema:
            type: string
            format: date
          description: Date to query to in YYYYMMDD format
        - in: query
          name: page
          schema:
            type: integer
          description: Page number
        - in: query
          name: page_size
          schema:
            type: integer
          description: Items / page
        - in: query
          name: state
          schema:
            type: string
          description: Two-letter US state code, e.g. CA
        - in: query
          name: ticker
          schema:
            type: string
          description: Ticker for any given stock
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WarnNoticesResponse'
          description: ''
      security:
        - WebPlatformTokenAuth: []
components:
  schemas:
    WarnNoticesResponse:
      title: WarnNoticesResponse
      description: JSON Response structure for the WARN notices endpoint.
      type: array
      items:
        $ref: '#/components/schemas/WarnNotice'
    WarnNotice:
      title: WarnNotice
      description: >-
        A WARN Act layoff or closure notice filed with a state, matched to a
        public company.
      type: object
      properties:
        NoticeID:
          title: Noticeid
          description: Notice identifier, stable across updates
          type: string
        Ticker:
          title: Ticker
          description: Ticker of the employer
          type: string
        Employer:
          title: Employer
          description: Employer as named on the notice
          type: string
        State:
          title: State
          description: Two-letter code of the state the notice was filed in
          type: string
        City:
          title: City
          description: City of the affected site
          type: string
        County:
          title: County
          description: County of the affected site
          type: string
        NoticeDate:
          title: Noticedate
          description: Date of the notice
          type: string
          format: date
        EffectiveDate:
          title: Effectivedate
          description: Date the layoff or closure takes effect, when given
          type: string
          format: date
        ReceivedDate:
          title: Receiveddate
          description: Date the state received the notice, when given
          type: string
          format: date
        EmployeesAffected:
          title: Employeesaffected
          description: Number of employees affected
          type: integer
        LayoffType:
          title: Layofftype
          description: >-
            Type of action as reported by the state (e.g. Layoff Permanent,
            Closure Temporary)
          type: string
        Industry:
          title: Industry
          description: Industry as reported by the state, when given
          type: string
        TickerMatchType:
          title: Tickermatchtype
          description: 'How the employer was matched to a ticker: exact, fuzzy, or search'
          type: string
        TickerMatchConfidence:
          title: Tickermatchconfidence
          description: Confidence of the ticker match (0-1)
          type: number
        FirstSeen:
          title: Firstseen
          description: >-
            When Quiver first collected the notice; use it for point-in-time
            backtests, since states often post notices days or weeks after the
            notice date
          type: string
          format: date-time
      required:
        - NoticeID
        - Ticker
  securitySchemes:
    WebPlatformTokenAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.