addedInput schema / properties / state / properties / okAgi
Added value: +{
+ "description": "Oklahoma adjusted gross income (Form 511 line 7) — the proration numerator when it is below federal AGI (Schedules 511-F and 511-G: credit x line 7 / line 1, not more than 100%). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okBasicExemptions
Added value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of Oklahoma exemptions with NO income test: 'yourself' + 'spouse' regular boxes, legally-blind boxes, and dependents (Form 511 page 1) — $1,000 each (us.ok.exemptions). A filer claimable as someone's dependent enters 0 for 'yourself'."
+}
addedInput schema / properties / state / properties / okEic2020Amount
Added value: +{
+ "description": "The federal earned income credit computed under 2020 rules on Form 511-EIC line 20 (the larger of the 2024 and 2025 columns — each is us.ok.eic_2020_rules) — us.ok.eic pays 5% of it, prorated by Oklahoma AGI over federal AGI. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okEicAgi
Added value: +{
+ "description": "Federal AGI (Form 1040 line 11) for the SAME year as okEicEarnedIncome — Form 511-EIC line 17: when it reaches the table's phase-out row ($8,800 no children / $19,350 with children; $14,700 / $25,250 married filing jointly) the credit is the SMALLER of the table amounts at earned income and at AGI (us.ok.eic_2020_rules). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okEicEarnedIncome
Added value: +{
+ "description": "Total earned income on Form 511-EIC line 15 (wages less excluded Medicaid waiver payments, plus elected nontaxable combat pay, plus net self-employment earnings) for the year being computed — Oklahoma lets the filer use 2025 OR 2024 earned income (us.ok.eic_2020_rules; run once per year and keep the larger). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okEicEligible
Added value: +{
+ "description": "Filer meets the FEDERAL 2020-law EIC requirements Oklahoma freezes to (68 O.S. § 2357.43): work-valid SSNs, not married filing separately, investment income $3,650 or less, and — with no qualifying child — age 25 to 64 and not a dependent (us.ok.eic_2020_rules). Unattested = $0.",
+ "type": "boolean"
+}
addedInput schema / properties / state / properties / okEicQualifyingChildren
Added value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of EIC qualifying children under the 2020 federal rules (0, 1, 2, or 3-or-more — the table caps at 3) for us.ok.eic_2020_rules."
+}
addedInput schema / properties / state / properties / okFederalAgi
Added value: +{
+ "description": "Federal adjusted gross income (Form 511 line 1 = Form 1040 line 11) — keys the $100,000 child care/child tax credit cliff and the Schedule 511-F/511-G proration denominators (us.ok.child_care_child_tax_credit, us.ok.eic), the special 65+ exemption income limits (us.ok.exemptions, after removing Roth conversion income), and the use tax table (us.ok.use_tax). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okFederalCharity
Added value: +{
+ "description": "Gifts to charity deducted on federal Schedule A line 14 (Schedule 511-D lines 5 and 10) — exempt from Oklahoma's $17,000 itemized cap (us.ok.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okFederalChildCareCredit
Added value: +{
+ "description": "Federal credit for child and dependent care expenses allowed (Form 2441 / Schedule 3 line 2) — Oklahoma allows 20% of it (us.ok.child_care_child_tax_credit, the greater-of test). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okFederalChildTaxCredit
Added value: +{
+ "description": "Federal child tax credit PLUS additional child tax credit allowed (Form 1040 line 19 + line 28 from Schedule 8812) — Oklahoma allows 5% of the total (us.ok.child_care_child_tax_credit, the greater-of test). NOTE: line 19 also carries the $500 § 24(h)(4) credit for other dependents; the packet names only the CTC and ACTC — the ODC is part of § 24 (\"the child tax credit allowed under the IRC\"), so include it but disclose when one is present. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okFederalItemizedTotal
Added value: +{
+ "description": "Federal Schedule A line 17 total itemized deductions (Schedule 511-D line 1) — the starting point for Oklahoma itemized deductions (us.ok.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okFederalMedical
Added value: +{
+ "description": "Medical and dental expenses deducted on federal Schedule A line 4 (Schedule 511-D lines 4 and 9) — exempt from Oklahoma's $17,000 itemized cap (us.ok.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okFederalSaltDeducted
Added value: +{
+ "description": "State and local income OR general sales taxes from federal Schedule A line 5a to the extent actually included in line 5e after the SALT cap (Schedule 511-D line 2) — Oklahoma adds them back (us.ok.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okGovRetirementSpouse
Added value: +{
+ "description": "SPOUSE's Oklahoma-government or federal civil service retirement benefits included in federal AGI (Schedule 511-A line 5) — the $10,000 limit is per individual, in that person's name (us.ok.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okGovRetirementYou
Added value: +{
+ "description": "TAXPAYER's Oklahoma-government or federal civil service retirement benefits included in federal AGI (Schedule 511-A line 5 systems: OPERS, TRS, OLERS, firefighters, police, judges, county/municipal systems, US civil service other than CSRS-in-lieu-of-SS) — excluded up to $10,000 per person (us.ok.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okGrossHouseholdIncome
Added value: +{
+ "description": "Total GROSS household income of everyone in the household, taxable or not (Form 538-S Part 3 line 14: wages incl. nontaxable W-2 amounts, interest, dependents' income, full Social Security incl. Medicare, pensions, alimony, unemployment, EIC received, public assistance, child support, workers' comp, gross rents/business receipts; NOT deferred 401(k)/IRA contributions) — the $20,000/$50,000 sales tax relief limits (us.ok.sales_tax_relief_credit) and the $12,000 property tax relief limit (us.ok.property_tax_relief_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okOtherRetirementSpouse
Added value: +{
+ "description": "SPOUSE's other qualifying retirement income included in federal AGI (Schedule 511-A line 6) — same per-person $10,000 combined limit (us.ok.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okOtherRetirementYou
Added value: +{
+ "description": "TAXPAYER's other qualifying retirement income included in federal AGI (Schedule 511-A line 6: IRC 401 plans, 457 plans, 408 IRAs/SEPs, 403(a)/(b) annuities, 402(e) lump sums) — excluded up to $10,000 per person MINUS the same person's line 5 exclusion (us.ok.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okPropertyTaxPaid
Added value: +{
+ "description": "Ad valorem property taxes paid on the homestead occupied during the year (Form 538-H) — the property tax relief credit is the amount paid, capped at $200 (us.ok.property_tax_relief_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okPtrEligible
Added value: +{
+ "description": "Filer is 65 or older OR totally disabled, is the head of a household, and was an Oklahoma resident domiciled in the state for the ENTIRE preceding calendar year (Form 538-H / Form 511 line 24) — the property tax relief credit also requires gross household income of $12,000 or less (us.ok.property_tax_relief_credit). Unattested = $0.",
+ "type": "boolean"
+}
addedInput schema / properties / state / properties / okRothConversionIncome
Added value: +{
+ "description": "Income from converting a traditional IRA to a Roth IRA that is included in federal AGI — excluded from federal AGI ONLY for the special 65+ exemption income limits (68 O.S. § 2358(E)(1)(c); Form 511 exemption instructions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}
addedInput schema / properties / state / properties / okSpecialExemptions65
Added value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of Oklahoma SPECIAL exemption boxes (taxpayer and/or spouse 65 or older at year end, 0-2) — $1,000 each ONLY when federal AGI (less Roth conversion income) is at or under $15,000 single / $25,000 joint / $12,500 MFS / $19,000 head of household (us.ok.exemptions)."
+}
addedInput schema / properties / state / properties / okStrDisabled
Added value: +{
+ "description": "Filer or spouse has a physical disability constituting a substantial handicap to employment (proof required with Form 538-S) — raises the sales tax relief gross household income limit to $50,000 (us.ok.sales_tax_relief_credit).",
+ "type": "boolean"
+}
addedInput schema / properties / state / properties / okStrEligible
Added value: +{
+ "description": "Filer meets the Form 538-S gates: Oklahoma resident (domiciled) for the ENTIRE year, not an inmate in DOC custody during the year after a felony conviction, received no TANF in any month, not living in Oklahoma under a visa, and the return is filed by the due date (us.ok.sales_tax_relief_credit). Unattested = $0.",
+ "type": "boolean"
+}
addedInput schema / properties / state / properties / okStrExemptions
Added value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Qualified exemptions for the sales tax relief credit (Form 538-S Box D: yourself, spouse, and each federally-claimed dependent who was an Oklahoma resident all year; a deceased taxpayer/spouse or a TANF recipient does not count) — $40 each (us.ok.sales_tax_relief_credit)."
+}
addedInput schema / properties / state / properties / okStrHasDependent
Added value: +{
+ "description": "Filer can claim an exemption for a dependent — raises the sales tax relief gross household income limit from $20,000 to $50,000 (us.ok.sales_tax_relief_credit).",
+ "type": "boolean"
+}
addedInput schema / properties / state / properties / okStrIs65
Added value: +{
+ "description": "Filer or spouse is 65 or older by December 31 of the tax year — raises the sales tax relief gross household income limit to $50,000 (us.ok.sales_tax_relief_credit).",
+ "type": "boolean"
+}