{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://askcalculators.com/uk/paycheck/schema.json",
  "title": "Paycheck Planning Calculator — United Kingdom inputs",
  "description": "Estimate ordinary employment take-home pay from dated country tax and contribution rules. Canada, UK and Ireland use the selected supported contribution class; the national US view requires an explicit verified payroll amount. GBP planning view; stated limitations apply.",
  "type": "object",
  "properties": {
    "grossIncome": {
      "title": "Annual gross income",
      "type": "number",
      "description": "Illustrative starting value; replace with your own evidence.",
      "default": 60000,
      "minimum": 0,
      "maximum": 1000000000000,
      "x-step": 0.01,
      "x-prefix": "GBP",
      "x-unit": "currency"
    },
    "deductions": {
      "title": "Additional deductible amount (not a tax credit)",
      "type": "number",
      "description": "Illustrative starting value; replace with your own evidence.",
      "default": 0,
      "minimum": 0,
      "maximum": 1000000000000,
      "x-step": 0.01,
      "x-prefix": "GBP",
      "x-unit": "currency"
    },
    "credits": {
      "title": "Additional verified nonrefundable national credits",
      "type": "number",
      "description": "Illustrative starting value; replace with your own evidence.",
      "default": 0,
      "minimum": 0,
      "maximum": 1000000000000,
      "x-step": 0.01,
      "x-prefix": "GBP",
      "x-unit": "currency"
    },
    "nation": {
      "title": "UK nation",
      "type": "string",
      "default": "england",
      "enum": [
        "england",
        "wales",
        "northern-ireland",
        "scotland"
      ],
      "x-optionLabels": {
        "england": "England",
        "wales": "Wales",
        "northern-ireland": "Northern Ireland",
        "scotland": "Scotland"
      }
    },
    "localIncomeTax": {
      "title": "Other state/local income tax not automatically included",
      "type": "number",
      "description": "Illustrative starting value; replace with your own evidence.",
      "default": 0,
      "minimum": 0,
      "maximum": 1000000000000,
      "x-step": 0.01,
      "x-prefix": "GBP",
      "x-unit": "currency"
    },
    "payPeriods": {
      "title": "Payments per year",
      "type": "string",
      "default": "12",
      "enum": [
        "12",
        "24",
        "26",
        "52"
      ],
      "x-optionLabels": {
        "12": "Monthly (12)",
        "24": "Twice monthly (24)",
        "26": "Fortnightly/biweekly (26)",
        "52": "Weekly (52)"
      }
    },
    "socialMode": {
      "title": "Employee contribution calculation",
      "type": "string",
      "default": "automatic",
      "enum": [
        "automatic",
        "manual"
      ],
      "x-optionLabels": {
        "automatic": "Use supported country contribution rules",
        "manual": "Use my verified annual contribution amount"
      }
    },
    "niCategory": {
      "title": "UK National Insurance category",
      "type": "string",
      "default": "A",
      "enum": [
        "A",
        "B",
        "C",
        "D",
        "E",
        "F",
        "H",
        "I",
        "J",
        "K",
        "L",
        "M",
        "N",
        "S",
        "V",
        "Z"
      ],
      "x-optionLabels": {
        "A": "Category A",
        "B": "Category B",
        "C": "Category C",
        "D": "Category D",
        "E": "Category E",
        "F": "Category F",
        "H": "Category H",
        "I": "Category I",
        "J": "Category J",
        "K": "Category K",
        "L": "Category L",
        "M": "Category M",
        "N": "Category N",
        "S": "Category S",
        "V": "Category V",
        "Z": "Category Z"
      }
    },
    "annualSocial": {
      "title": "Verified annual employee contributions (manual mode only)",
      "type": "number",
      "description": "Illustrative starting value; replace with your own evidence.",
      "default": 0,
      "minimum": 0,
      "maximum": 1000000000000,
      "x-step": 0.01,
      "x-prefix": "GBP",
      "x-unit": "currency"
    },
    "annualBenefits": {
      "title": "Annual after-tax deductions/benefit cost",
      "type": "number",
      "description": "Illustrative starting value; replace with your own evidence.",
      "default": 0,
      "minimum": 0,
      "maximum": 1000000000000,
      "x-step": 0.01,
      "x-prefix": "GBP",
      "x-unit": "currency"
    }
  },
  "required": [
    "grossIncome",
    "deductions",
    "credits",
    "nation",
    "localIncomeTax",
    "payPeriods",
    "socialMode",
    "niCategory",
    "annualSocial",
    "annualBenefits"
  ],
  "additionalProperties": false,
  "x-askcalculators": {
    "version": "20.16.0",
    "calculatorUrl": "https://askcalculators.com/uk/paycheck/",
    "queryExample": "https://askcalculators.com/uk/paycheck/?grossIncome=60000&deductions=0&credits=0&nation=england&localIncomeTax=0&payPeriods=12&socialMode=automatic&niCategory=A&annualSocial=0&annualBenefits=0",
    "migrationStatus": "new",
    "reviewStatus": "pending",
    "pageStatus": "live",
    "workStatus": "pending",
    "formula": {
      "expression": "Payment = (gross income − modeled annual taxes − selected automatic or manual employee contributions − after-tax deductions) / pay periods.",
      "note": "Inputs are converted to canonical units before evaluating this stated formula."
    },
    "quality": {
      "availability": "live",
      "technicalReviewRecord": "/reviews/v20-uk-paycheck.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."
    },
    "outputs": {
      "automaticCredits": {
        "title": "Supported basic national credits before final tax limitations",
        "type": "number",
        "x-format": "currency",
        "x-currency": "GBP",
        "x-digits": 2
      },
      "provincialTax": {
        "title": "Canadian provincial/territorial tax (zero outside Canada)",
        "type": "number",
        "x-format": "currency",
        "x-currency": "GBP",
        "x-digits": 2
      },
      "taxable": {
        "title": "Taxable income used",
        "type": "number",
        "x-format": "currency",
        "x-currency": "GBP",
        "x-digits": 2
      },
      "baseTax": {
        "title": "National bracket tax before credits",
        "type": "number",
        "x-format": "currency",
        "x-currency": "GBP",
        "x-digits": 2
      },
      "tax": {
        "title": "Income tax after supported credits and local/provincial tax",
        "type": "number",
        "x-format": "currency",
        "x-currency": "GBP",
        "x-digits": 2
      },
      "usc": {
        "title": "Irish USC (zero outside Ireland)",
        "type": "number",
        "x-format": "currency",
        "x-currency": "GBP",
        "x-digits": 2
      },
      "total": {
        "title": "Total modeled taxes",
        "type": "number",
        "x-format": "currency",
        "x-currency": "GBP",
        "x-digits": 2,
        "x-primary": true
      },
      "net": {
        "title": "Gross income less modeled taxes",
        "type": "number",
        "x-format": "currency",
        "x-currency": "GBP",
        "x-digits": 2
      },
      "effectiveRate": {
        "title": "Modeled effective rate",
        "type": "number",
        "x-format": "percent",
        "x-digits": 2
      },
      "social": {
        "title": "Modeled employee social/payroll contributions",
        "type": "number",
        "x-format": "currency",
        "x-currency": "GBP",
        "x-digits": 2
      },
      "netPay": {
        "title": "Estimated payment after contributions and deductions",
        "type": "number",
        "x-format": "currency",
        "x-currency": "GBP",
        "x-digits": 2,
        "x-primary": true
      }
    }
  }
}