{"openapi":"3.1.0","info":{"title":"Kentucky Withholding Tax Calculator 2026 (2026)","version":"2026.1.0","description":"Calculate Kentucky 2026 employer withholding from taxable wages and exact pay-frequency selections using the publisher's workbook. selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.","x-formualizer-Provenance":{"publisher":"Kentucky Department of Revenue","publisherPageUrl":"https://revenue.ky.gov/Business/Pages/Employer-Payroll-Withholding.aspx","sourceUrl":"https://revenue.ky.gov/Business/Documents/2026%20Withholding%20Tax%20Calculator.xlsx","publishedDate":null,"workbookFilename":"ky-withholding-2026.xlsx","workbookSha256":"a4a7d6bd5813c12e576ee498c3584e3c14198846ae83209fdab6b1656191fada","workbookBytes":115509,"format":"xlsx","licenseClass":"public-domain-gov","editionEvidence":"Calculation of Withholding!A1 identifies 2026."},"x-formualizer-VerificationLevel":"scenario-independent-arithmetic","x-formualizer-WorkbookDownload":{"mode":"catalog-bytes","sourceUrl":"https://revenue.ky.gov/Business/Documents/2026%20Withholding%20Tax%20Calculator.xlsx","sha256":"a4a7d6bd5813c12e576ee498c3584e3c14198846ae83209fdab6b1656191fada","bytes":115509},"x-formualizer-Flows":[{"id":"quick_withholding","title":"Quick Kentucky withholding","kind":"single","inputPorts":["pay_frequency","taxable_wages"],"outputPorts":["withholding"]},{"id":"full_payroll","title":"Full Kentucky payroll schedule","kind":"single","inputPorts":["pay_frequency","taxable_wages","employee_names","frequency_schedule","wages_schedule"],"outputPorts":["withholding","second_employee_withholding","last_employee_withholding"]}]},"paths":{"/evaluate":{"post":{"operationId":"evaluateWorkbook","parameters":[{"name":"tablePort","in":"query","description":"Table input port receiving NDJSON rows or Arrow IPC; omit for scenario envelopes","schema":{"type":"string","enum":[]}},{"name":"flow","in":"query","description":"Named input/output flow (default: quick_withholding)","schema":{"type":"string","enum":["quick_withholding","full_payroll"],"default":"quick_withholding"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"inputs":{"$ref":"#/components/schemas/Inputs"}},"required":["inputs"]}},"application/x-ndjson":{"schema":{"type":"string","description":"Table rows with tablePort, otherwise scenario envelopes"}},"application/vnd.apache.arrow.stream":{"schema":{"type":"string","format":"binary"}},"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"Workbook outputs","content":{"application/json":{"schema":{"type":"object","properties":{"outputs":{"$ref":"#/components/schemas/Outputs"}}}},"application/x-ndjson":{"schema":{"type":"string","description":"Scenario results, one JSON envelope per line"}}}}}}},"/evaluate-batch":{"post":{"operationId":"evaluateWorkbookBatch","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scenarios":{"type":"array","items":{"type":"object","properties":{"id":{},"inputs":{"$ref":"#/components/schemas/Inputs"}},"required":["inputs"]}}},"required":["scenarios"]}},"application/x-ndjson":{"schema":{"type":"string","description":"Scenario envelopes, one per line"}}}},"responses":{"200":{"description":"Scenario results (including per-scenario errors)","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{},"outputs":{"$ref":"#/components/schemas/Outputs"},"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}},"application/x-ndjson":{"schema":{"type":"string"}}}}}}},"/ports":{"get":{"operationId":"describePorts","responses":{"200":{"description":"Workbook manifest and ports","content":{"application/json":{"schema":{"type":"object","properties":{"manifest":{"type":"object"},"ports":{"type":"array","items":{"type":"object"}}}}}}}}}},"/types.d.ts":{"get":{"operationId":"typeDeclarations","responses":{"200":{"description":"TypeScript Inputs, Outputs and Client declarations","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/models/{slug}/{edition}/workbook.xlsx":{"get":{"summary":"Download catalog workbook or follow publisher redirect","description":"Download mode: catalog-bytes. Reference-only workbooks redirect to the publisher. The sha256 and bytes metadata pin the catalog file, which may be a sanitized derivative. When present, upstreamArtifact separately pins the publisher file. fio.yaml remains downloadable.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","enum":["ky-withholding-tax"]}},{"name":"edition","in":"path","required":true,"schema":{"type":"string","enum":["2026"]}}],"responses":{"200":{"description":"Catalog workbook bytes; upstreamArtifact separately identifies publisher bytes when sanitized","headers":{"x-workbook-sha256":{"schema":{"type":"string"},"description":"a4a7d6bd5813c12e576ee498c3584e3c14198846ae83209fdab6b1656191fada"},"x-workbook-bytes":{"schema":{"type":"integer"},"description":"115509"}}}}}}},"components":{"schemas":{"Inputs":{"type":"object","properties":{"pay_frequency":{"type":["string","null"],"enum":["Monthly","Semi Monthly","Weekly","BI-Weekly","Daily","Annual"],"description":"Exact source enum: Monthly (12), Semi Monthly (24), Weekly (52), BI-Weekly (26), Daily (365), Annual (1). Source default blank/null; required with positive wages. No mode switch.","default":null},"taxable_wages":{"type":["number","null"],"minimum":0,"description":"Nonnegative USD taxable wages for one pay period; source default blank/null treated as zero. Supply taxable wages after applicable payroll exclusions, not annual gross wages.","default":null},"employee_names":{"type":"array","items":{"type":"array","items":{"type":"string"}},"description":"Optional 1994×1 employee labels; source blank. Labels have no tax effect. Row index 0 corresponds to Excel row 7."},"frequency_schedule":{"type":"array","items":{"type":"array","items":{"type":"string"}},"description":"1994×1 exact frequency strings or null, rows 7–2000. Allowed nonblank values: Monthly, Semi Monthly, Weekly, BI-Weekly, Daily, Annual. Source cells blank. Positive wages require a frequency in the same row. Do not also set overlapping scalar pay_frequency in the same request."},"wages_schedule":{"type":"array","items":{"type":"array","items":{"type":"number"}},"description":"1994×1 nonnegative USD per-period taxable wages or null, rows 7–2000; source blank. Do not also set overlapping scalar taxable_wages in the same request."}},"required":[],"additionalProperties":false},"Outputs":{"type":"object","properties":{"withholding":{"type":"number","description":"Nonnegative USD withholding for row 7, unrounded source formula (display formats show cents). Runtime N(originalFormula) converts source display blanks to zero."},"second_employee_withholding":{"type":"number","description":"Nonnegative USD withholding for source row 8; full-flow diagnostic."},"last_employee_withholding":{"type":"number","description":"Nonnegative USD withholding for source row 2000; full-flow boundary diagnostic."}},"required":["withholding","second_employee_withholding","last_employee_withholding"],"additionalProperties":false}}}}