{
  "openapi": "3.0.3",
  "info": {
    "title": "LayoffLens API",
    "version": "0.1.0",
    "description": "Normalized, source-linked U.S. WARN Act layoff and plant-closure notices from 24 states (covering the largest economies and the majority of U.S. layoff activity). Filter by state, company, date, or headcount; every record links back to its official state filing, with a live per-state coverage map at /v1/states/{state}/status. Updated daily. Informational/transparency use; not legal or investment advice."
  },
  "servers": [
    {
      "url": "https://layofflens-api.remulouslabs.com"
    }
  ],
  "x-tiers": {
    "description": "Quota-only: every plan returns the same full data and all filters; plans differ only by monthly call quota, enforced by the RapidAPI gateway."
  },
  "paths": {
    "/v1/notices": {
      "get": {
        "summary": "Filtered notice list",
        "parameters": [
          {
            "name": "state",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "AL",
                "AZ",
                "CA",
                "CO",
                "DC",
                "DE",
                "FL",
                "IA",
                "ID",
                "IL",
                "IN",
                "KS",
                "MD",
                "ME",
                "NC",
                "NE",
                "NJ",
                "NM",
                "OH",
                "OR",
                "PA",
                "RI",
                "SC",
                "SD",
                "TX",
                "UT",
                "VT",
                "WA"
              ]
            }
          },
          {
            "name": "employer",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ticker",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "closure_type",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "layoff",
                "closure",
                "unknown"
              ]
            }
          },
          {
            "name": "min_affected",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "notice_from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "notice_to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "effective_from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "effective_to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Notices"
          },
          "400": {
            "description": "Invalid parameter"
          }
        }
      }
    },
    "/v1/notices/{id}": {
      "get": {
        "summary": "One notice",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Notice"
          },
          "404": {
            "description": "Not found"
          }
        }
      }
    },
    "/v1/companies/{name}/notices": {
      "get": {
        "summary": "Notices for one employer",
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Notices"
          },
          "404": {
            "description": "None"
          }
        }
      }
    },
    "/v1/states/{state}/status": {
      "get": {
        "summary": "Per-state coverage / freshness",
        "parameters": [
          {
            "name": "state",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "AL",
                "AZ",
                "CA",
                "CO",
                "DC",
                "DE",
                "FL",
                "IA",
                "ID",
                "IL",
                "IN",
                "KS",
                "MD",
                "ME",
                "NC",
                "NE",
                "NJ",
                "NM",
                "OH",
                "OR",
                "PA",
                "RI",
                "SC",
                "SD",
                "TX",
                "UT",
                "VT",
                "WA"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Coverage"
          }
        }
      }
    },
    "/v1/meta": {
      "get": {
        "summary": "Totals, coverage, sources",
        "responses": {
          "200": {
            "description": "Metadata"
          }
        }
      }
    },
    "/healthz": {
      "get": {
        "summary": "Liveness",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  }
}