{
  "id": "v20-us-unemployment",
  "version": "20.16.0",
  "name": "Unemployment Benefit Budget Planner — United States",
  "shortName": "Unemployment Benefit Budget Planner",
  "description": "Budget from an actual agency award with an explicitly verified partial-earnings rule. This does not determine eligibility, base-period wages, extensions or the maximum benefit award. USD planning view; stated limitations apply.",
  "category": "Finance",
  "categorySlug": "finance",
  "keywords": [
    "unemployment",
    "us",
    "legal-authority"
  ],
  "status": "live",
  "workStatus": "pending",
  "reviewStatus": "pending",
  "migrationStatus": "new",
  "engine": "native",
  "creator": null,
  "reviewer": null,
  "quality": {
    "availability": "live",
    "technicalReviewRecord": "/reviews/v20-us-unemployment.json",
    "qualifiedReview": "pending",
    "qualifiedReviewer": null,
    "qualifiedReviewDate": null,
    "formulaVersion": "20.16.0",
    "referenceCoverage": "references-listed",
    "releaseTestScope": "Catalog and regression checks are not a professional formula audit; consult release evidence.",
    "historicalMetadataDate": "",
    "historicalMetadataNotice": "The imported date is not evidence of a completed human review."
  },
  "notice": "Illustrative defaults are not local quotes or verified legal rules. Dated reference components and user-entered assumptions are explicitly distinguished. Professional review is pending.",
  "urls": {
    "page": "/us/unemployment/",
    "definition": "/us/unemployment/definition.json",
    "schema": "/us/unemployment/schema.json",
    "llms": "/us/unemployment/llms.txt",
    "legacyDefinition": "/us/unemployment/definition.json"
  },
  "queryExample": "https://askcalculators.com/us/unemployment/?weeklyAward=300&weeks=12&waitingWeeks=0&earnings=0&disregard=0&offset=100&withholding=0&rulesConfirmed=0",
  "queryParameters": {
    "weeklyAward": {
      "label": "Weekly benefit in verified agency award",
      "type": "money",
      "required": true,
      "default": 300
    },
    "weeks": {
      "label": "Remaining eligible payable weeks",
      "type": "number",
      "required": true,
      "default": 12
    },
    "waitingWeeks": {
      "label": "Unpaid waiting weeks within this budget period",
      "type": "number",
      "required": true,
      "default": 0
    },
    "earnings": {
      "label": "Weekly earnings during claim",
      "type": "money",
      "required": true,
      "default": 0
    },
    "disregard": {
      "label": "Verified weekly earnings disregard",
      "type": "money",
      "required": true,
      "default": 0
    },
    "offset": {
      "label": "Verified reduction rate on excess earnings",
      "type": "percent",
      "required": true,
      "default": 100
    },
    "withholding": {
      "label": "Voluntary withholding assumption",
      "type": "percent",
      "required": true,
      "default": 0
    },
    "rulesConfirmed": {
      "label": "Applicable jurisdiction rules and entered amounts independently verified",
      "type": "checkbox",
      "required": false,
      "default": false
    }
  },
  "inputs": [
    {
      "id": "weeklyAward",
      "label": "Weekly benefit in verified agency award",
      "type": "money",
      "defaultValue": 300,
      "required": true,
      "min": 0,
      "max": 1000000000000,
      "step": 0.01,
      "prefix": "USD",
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "weeks",
      "label": "Remaining eligible payable weeks",
      "type": "number",
      "defaultValue": 12,
      "required": true,
      "min": 0,
      "max": 104,
      "step": 1,
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "waitingWeeks",
      "label": "Unpaid waiting weeks within this budget period",
      "type": "number",
      "defaultValue": 0,
      "required": true,
      "min": 0,
      "max": 4,
      "step": 1,
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "earnings",
      "label": "Weekly earnings during claim",
      "type": "money",
      "defaultValue": 0,
      "required": true,
      "min": 0,
      "max": 1000000000000,
      "step": 0.01,
      "prefix": "USD",
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "disregard",
      "label": "Verified weekly earnings disregard",
      "type": "money",
      "defaultValue": 0,
      "required": true,
      "min": 0,
      "max": 1000000000000,
      "step": 0.01,
      "prefix": "USD",
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "offset",
      "label": "Verified reduction rate on excess earnings",
      "type": "percent",
      "defaultValue": 100,
      "required": true,
      "min": 0,
      "max": 100,
      "step": 0.1,
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "withholding",
      "label": "Voluntary withholding assumption",
      "type": "percent",
      "defaultValue": 0,
      "required": true,
      "min": 0,
      "max": 100,
      "step": 0.1,
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "rulesConfirmed",
      "label": "Applicable jurisdiction rules and entered amounts independently verified",
      "type": "checkbox",
      "defaultValue": false
    }
  ],
  "outputs": [
    {
      "id": "weekly",
      "label": "Modeled payable weekly amount",
      "format": "currency",
      "digits": 2,
      "currency": "USD"
    },
    {
      "id": "payableWeeks",
      "label": "Budgeted payable weeks",
      "format": "integer",
      "digits": 2
    },
    {
      "id": "gross",
      "label": "Modeled gross benefit for period",
      "format": "currency",
      "digits": 2,
      "primary": true,
      "currency": "USD"
    },
    {
      "id": "net",
      "label": "Modeled cash after entered withholding",
      "format": "currency",
      "digits": 2,
      "currency": "USD"
    }
  ],
  "formula": {
    "expression": "Weekly amount = max(0, agency award − max(0, weekly earnings − disregard) × offset rate). Period amount = weekly amount × payable weeks.",
    "note": "Inputs are converted to canonical units before evaluating this stated formula."
  },
  "examples": [
    {
      "label": "Illustrative defaults; required verification checks remain unconfirmed",
      "inputs": {
        "unitSystem": "imperial",
        "weeklyAward": 300,
        "weeks": 12,
        "waitingWeeks": 0,
        "earnings": 0,
        "disregard": 0,
        "offset": 100,
        "withholding": 0,
        "rulesConfirmed": false
      }
    }
  ],
  "sources": [
    {
      "label": "US legal help and official resources",
      "url": "https://www.usa.gov/legal-aid"
    }
  ],
  "publicSlug": "unemployment",
  "namespace": "us",
  "countries": [
    "us"
  ]
}
