LayoffNotice

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/api-ninjas-com/json-schema/api-ninjas-com-layoff-notice-schema.json",
  "title": "LayoffNotice",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/api-ninjas-com-openapi.json#/components/schemas/LayoffNotice",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique id of the notice. It does not change when the notice is updated."
    },
    "state": {
      "type": "string",
      "description": "Two-letter code of the state the notice was filed in.",
      "enum": [
        "AK",
        "AL",
        "AZ",
        "CA",
        "CO",
        "CT",
        "DC",
        "DE",
        "FL",
        "GA",
        "HI",
        "IA",
        "ID",
        "IL",
        "IN",
        "KS",
        "KY",
        "LA",
        "MA",
        "MD",
        "ME",
        "MI",
        "MN",
        "MO",
        "MS",
        "MT",
        "NC",
        "ND",
        "NE",
        "NH",
        "NJ",
        "NM",
        "NV",
        "NY",
        "OH",
        "OK",
        "OR",
        "PA",
        "RI",
        "SC",
        "SD",
        "TN",
        "TX",
        "UT",
        "VA",
        "VT",
        "WA",
        "WI",
        "WV"
      ]
    },
    "agency": {
      "type": "string",
      "description": "The state agency that received the notice."
    },
    "employer": {
      "type": "string",
      "description": "The employer's name, as filed."
    },
    "employer_dba": {
      "type": [
        "string",
        "null"
      ],
      "description": "The \"doing business as\" or site name in the notice, if any."
    },
    "company": {
      "allOf": [
        {
          "$ref": "#/$defs/LayoffCompany"
        }
      ],
      "nullable": true,
      "x-premium": true,
      "description": "Premium only (Developer plans and above). The company the notice is matched to, or null when the employer is not matched to a company. The free plan receives the string \"This field is for premium subscribers only.\" instead."
    },
    "event_type": {
      "type": "string",
      "description": "The action in the notice.",
      "enum": [
        "layoff",
        "closure",
        "relocation",
        "furlough",
        "reduced_hours",
        "other",
        "unknown"
      ]
    },
    "temporary": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "true for a temporary layoff, false for a permanent one, null when the notice does not say."
    },
    "warn_notice": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "true for a notice filed under the federal WARN Act or a state WARN law; false for a layoff the state reports below the WARN thresholds; null when the state does not say."
    },
    "status": {
      "type": "string",
      "description": "filed, amended (the employer filed an amendment), rescinded (withdrawn) or postponed.",
      "enum": [
        "filed",
        "amended",
        "rescinded",
        "postponed"
      ]
    },
    "notice_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date of the notice (YYYY-MM-DD).",
      "format": "date"
    },
    "received_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date the agency received the notice (YYYY-MM-DD).",
      "format": "date"
    },
    "effective_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date the layoff or closure takes effect (YYYY-MM-DD).",
      "format": "date"
    },
    "effective_date_end": {
      "type": [
        "string",
        "null"
      ],
      "description": "For a layoff that takes place over a period, e.g. in phases: its last date (YYYY-MM-DD).",
      "format": "date"
    },
    "date_precision": {
      "type": [
        "object",
        "null"
      ],
      "description": "Only for dates known to the month or year: each such date field with month or year, e.g. {\"effective_date\": \"month\"}. The date is then the first day of that month or year. null when every date is exact.",
      "additionalProperties": {
        "type": "string",
        "enum": [
          "month",
          "year"
        ]
      }
    },
    "workers": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of workers affected."
    },
    "locations": {
      "type": "array",
      "description": "Every location in the notice.",
      "items": {
        "$ref": "#/$defs/LayoffLocation"
      }
    },
    "naics": {
      "type": [
        "string",
        "null"
      ],
      "description": "NAICS industry code, 2 to 6 digits."
    },
    "industry": {
      "type": [
        "string",
        "null"
      ],
      "description": "Industry."
    },
    "union": {
      "type": [
        "string",
        "null"
      ],
      "description": "The union representing the affected workers, or whether they have one, as given in the notice."
    },
    "reason": {
      "type": [
        "string",
        "null"
      ],
      "description": "The reason given for the layoff."
    },
    "notice_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Premium only (Developer plans and above). Link to the official notice document. The free plan receives the string \"This field is for premium subscribers only.\" instead.",
      "format": "uri",
      "x-premium": true
    },
    "first_seen": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date the notice was added to the API (YYYY-MM-DD).",
      "format": "date"
    },
    "updated": {
      "type": "string",
      "description": "When any field of the notice last changed (ISO 8601, UTC). Use it with updated_since.",
      "format": "date-time"
    }
  },
  "$defs": {
    "LayoffCompany": {
      "type": "object",
      "description": "The company a notice is matched to.",
      "properties": {
        "name": {
          "type": "string",
          "description": "The company's name on the notice date."
        },
        "ticker": {
          "type": [
            "string",
            "null"
          ],
          "description": "The company's current stock ticker, when the company itself is listed. A ticker can change over time; cik does not. Returned for high-confidence matches; null for medium."
        },
        "exchange": {
          "type": [
            "string",
            "null"
          ],
          "description": "The exchange the ticker trades on, e.g. NYSE or Nasdaq. Returned for high-confidence matches; null for medium."
        },
        "cik": {
          "type": [
            "string",
            "null"
          ],
          "description": "The company's SEC Central Index Key (CIK), without leading zeros. Returned for high-confidence matches; null for medium."
        },
        "domain": {
          "type": [
            "string",
            "null"
          ],
          "description": "The company's website domain."
        },
        "parent": {
          "allOf": [
            {
              "$ref": "#/$defs/LayoffCompanyParent"
            }
          ],
          "nullable": true,
          "description": "When the employer is a subsidiary: its publicly traded parent company on the notice date, with name, ticker and cik. Returned for high-confidence matches; otherwise null."
        },
        "match_confidence": {
          "type": "string",
          "description": "How confident the match is.",
          "enum": [
            "high",
            "medium"
          ]
        }
      }
    },
    "LayoffCompanyParent": {
      "type": "object",
      "description": "The publicly traded parent company on the notice date, when the employer is a subsidiary.",
      "properties": {
        "name": {
          "type": "string",
          "description": "The parent company's name."
        },
        "ticker": {
          "type": [
            "string",
            "null"
          ],
          "description": "The parent company's current stock ticker."
        },
        "cik": {
          "type": [
            "string",
            "null"
          ],
          "description": "The parent company's SEC Central Index Key (CIK), without leading zeros."
        }
      }
    },
    "LayoffLocation": {
      "type": "object",
      "properties": {
        "address": {
          "type": [
            "string",
            "null"
          ],
          "description": "Street address, as filed."
        },
        "city": {
          "type": [
            "string",
            "null"
          ],
          "description": "City."
        },
        "county": {
          "type": [
            "string",
            "null"
          ],
          "description": "County."
        },
        "state": {
          "type": [
            "string",
            "null"
          ],
          "description": "Two-letter state code of an affected site."
        },
        "zip": {
          "type": [
            "string",
            "null"
          ],
          "description": "5-digit ZIP code."
        },
        "workers": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Number of workers affected at the location."
        },
        "type": {
          "type": [
            "string",
            "null"
          ],
          "description": "site (an affected workplace) or headquarters (the employer's headquarters address given in the notice); null when the notice does not say.",
          "enum": [
            "site",
            "headquarters"
          ]
        }
      }
    }
  }
}