{"openapi":"3.1.0","info":{"title":"OHFA 2023 4% LIHTC Underwriting Model (2023)","version":"2023.1.0","description":"Ohio Housing Finance Agency 2023 4% LIHTC eligible credit sizing, operating budget and cashflow sensitivity from the AHFA source application. 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":"Ohio Housing Finance Agency (OHFA)","publisherPageUrl":"https://ohiohome.org/ppd/resources.aspx","sourceUrl":"https://ohiohome.org/ppd/documents/2023-4-LIHTC-AHFA.xlsx","workbookFilename":"ohfa-lihtc-4pct-2023.xlsx","workbookSha256":"58435470f4a734061f1e8028ec7125f42c5f9f0c84e5d7fecac81c5a2018b007","workbookBytes":651440,"format":"xlsx","licenseClass":"reference-only"},"x-formualizer-VerificationLevel":"scenario-independent-arithmetic","x-formualizer-WorkbookDownload":{"mode":"publisher-redirect","sourceUrl":"https://ohiohome.org/ppd/documents/2023-4-LIHTC-AHFA.xlsx","sha256":"58435470f4a734061f1e8028ec7125f42c5f9f0c84e5d7fecac81c5a2018b007","bytes":651440},"x-formualizer-Flows":[{"id":"quick_lihtc_credit_sizing","title":"Quick LIHTC credit sizing","kind":"single","inputPorts":["units","monthly_tenant_rent","low_income_floor_area","market_floor_area","acquisition_basis","rehabilitation_basis","new_construction_basis","rehab_qct_fraction","new_qct_fraction","rehab_credit_rate","new_credit_rate","program","rent_limit_ami_fraction","first_year_vacancy","vacancy"],"outputPorts":["annual_credit_eligible","acquisition_credit","rehabilitation_credit","new_construction_credit","applicable_fraction"]},{"id":"full_underwriting_budget_cashflow","title":"Full underwriting budget and cashflow","kind":"single","inputPorts":["units","monthly_tenant_rent","low_income_floor_area","market_floor_area","acquisition_basis","rehabilitation_basis","new_construction_basis","rehab_qct_fraction","new_qct_fraction","rehab_credit_rate","new_credit_rate","program","rent_limit_ami_fraction","first_year_vacancy","vacancy","monthly_rental_subsidy","unit_square_feet","annual_residential_fees","annual_other_income","annual_commercial_income","annual_interest_income","annual_laundry_income","annual_office_expense","annual_electricity","annual_maintenance_supplies","annual_insurance","annual_replacement_reserve","senior_loan_amount","senior_loan_rate","senior_loan_amortization","income_escalation","expense_escalation","acquisition_credit_rate","acquisition_credit_reduction","rehabilitation_credit_reduction","new_construction_credit_reduction","gross_equity","equity_bridge_interest","equity_other_deductions"],"outputPorts":["annual_credit_eligible","acquisition_credit","rehabilitation_credit","new_construction_credit","applicable_fraction","effective_gross_income","operating_expenses","budget_noi","year_one_noi","year_one_cashflow","year_two_cashflow","senior_debt_service","year_one_dscr","net_equity"]}]},"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_lihtc_credit_sizing)","schema":{"type":"string","enum":["quick_lihtc_credit_sizing","full_underwriting_budget_cashflow"],"default":"quick_lihtc_credit_sizing"}}],"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: publisher-redirect. 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":["ohfa-lihtc-4pct"]}},{"name":"edition","in":"path","required":true,"schema":{"type":"string","enum":["2023"]}}],"responses":{"302":{"description":"Publisher redirect; no workbook bytes in response","headers":{"Location":{"schema":{"type":"string","format":"uri"}},"x-workbook-sha256":{"schema":{"type":"string"},"description":"58435470f4a734061f1e8028ec7125f42c5f9f0c84e5d7fecac81c5a2018b007"},"x-workbook-bytes":{"schema":{"type":"integer"},"description":"651440"}}}}}}},"components":{"schemas":{"Inputs":{"type":"object","properties":{"units":{"type":"number","minimum":0,"description":"Residential units, count; first rent-roll cohort; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!C9; effective default 0.","default":0},"monthly_tenant_rent":{"type":"number","minimum":0,"description":"USD per unit per month, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!I9; effective default 0.","default":0},"low_income_floor_area":{"type":"number","minimum":0,"description":"Square feet, low-income rental area; paired with market floor area; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Project Details!C230; effective default 0.","default":0},"market_floor_area":{"type":"number","minimum":0,"description":"Square feet, market rental area; applicable fraction is lesser of unit and floor fractions; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Project Details!C229; effective default 0.","default":0},"acquisition_basis":{"type":"number","minimum":0,"description":"USD, building acquisition eligible basis allocation; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F253; effective default 0.","default":0},"rehabilitation_basis":{"type":"number","minimum":0,"description":"USD, residential rehabilitation eligible basis allocation; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!G279; effective default 0.","default":0},"new_construction_basis":{"type":"number","minimum":0,"description":"USD, residential new construction eligible basis allocation; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!H278; effective default 0.","default":0},"rehab_qct_fraction":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1 of rehabilitation qualifying for 30% QCT/DDA boost; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!D13; effective default 0.0.","default":0},"new_qct_fraction":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1 of new construction qualifying for 30% QCT/DDA boost; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!E13; effective default 0.0.","default":0},"rehab_credit_rate":{"type":"number","minimum":0,"maximum":1,"description":"Annual decimal credit rate 0..1; nonnegative unless stated. Default 0.04 (blank numeric source cells act as zero).  Source location LIHTCs!D31; effective default 0.04.","default":0.04},"new_credit_rate":{"type":"number","minimum":0,"maximum":1,"description":"Annual decimal credit rate 0..1; nonnegative unless stated. Default 0.04 (blank numeric source cells act as zero).  Source location LIHTCs!E31; effective default 0.04.","default":0.04},"program":{"type":"string","enum":["","4% LIHTC","9% Competitive"],"description":"Text program switch: 4% LIHTC or 9% Competitive; activates competitive basis boost tests. Source default 4% LIHTC. Source location Project Details!C20; effective default 4% LIHTC.","default":"4% LIHTC"},"rent_limit_ami_fraction":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1, rent affordability AMI; does not override rent-limit compliance; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!G9; effective default 0.","default":0},"first_year_vacancy":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1, first-year cashflow vacancy; nonnegative unless stated. Default 0.07 (blank numeric source cells act as zero).  Source location Budget & Costs!E83; effective default 0.07.","default":0.07},"vacancy":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1, annual operating budget vacancy; nonnegative unless stated. Default 0.07 (blank numeric source cells act as zero).  Source location Budget & Costs!E82; effective default 0.07.","default":0.07},"monthly_rental_subsidy":{"type":"number","minimum":0,"description":"USD per unit per month; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!M9; effective default 0.","default":0},"unit_square_feet":{"type":"number","minimum":0,"description":"Square feet per cohort unit; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F9; effective default 0.","default":0},"annual_residential_fees":{"type":"number","minimum":0,"description":"USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F91; effective default 0.0.","default":0},"annual_other_income":{"type":"number","minimum":0,"description":"USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F92; effective default 0.0.","default":0},"annual_commercial_income":{"type":"number","minimum":0,"description":"USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F93; effective default 0.0.","default":0},"annual_interest_income":{"type":"number","minimum":0,"description":"USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F98; effective default 0.","default":0},"annual_laundry_income":{"type":"number","minimum":0,"description":"USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F103; effective default 0.0.","default":0},"annual_office_expense":{"type":"number","minimum":0,"description":"USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F116; effective default 0.0.","default":0},"annual_electricity":{"type":"number","minimum":0,"description":"USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F132; effective default 0.0.","default":0},"annual_maintenance_supplies":{"type":"number","minimum":0,"description":"USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F147; effective default 0.0.","default":0},"annual_insurance":{"type":"number","minimum":0,"description":"USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F162; effective default 0.0.","default":0},"annual_replacement_reserve":{"type":"number","minimum":0,"description":"USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F172; effective default 0.0.","default":0},"senior_loan_amount":{"type":"number","minimum":0,"description":"USD, positive principal; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!G240; effective default 0.0.","default":0},"senior_loan_rate":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1, annual interest; nonnegative unless stated. Default 0.06 (blank numeric source cells act as zero).  Source location Budget & Costs!H240; effective default 0.0.","default":0},"senior_loan_amortization":{"type":"number","minimum":0,"description":"Years, positive amortization term when loan amount >0; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!K240; effective default 0.","default":0},"income_escalation":{"type":"number","minimum":0,"maximum":1,"description":"Decimal annual fraction; nonnegative unless stated. Default 0.02 (blank numeric source cells act as zero).  Source location Cashflow!J25; effective default 0.02.","default":0.02},"expense_escalation":{"type":"number","minimum":0,"maximum":1,"description":"Decimal annual fraction; nonnegative unless stated. Default 0.03 (blank numeric source cells act as zero).  Source location Cashflow!J26; effective default 0.03.","default":0.03},"acquisition_credit_rate":{"type":"number","minimum":0,"maximum":1,"description":"Annual decimal credit rate 0..1; nonnegative unless stated. Default 0.04 (blank numeric source cells act as zero).  Source location LIHTCs!C31; effective default 0.04.","default":0.04},"acquisition_credit_reduction":{"type":"number","minimum":0,"description":"USD per year, positive credit reduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!C37; effective default 0.0.","default":0},"rehabilitation_credit_reduction":{"type":"number","minimum":0,"description":"USD per year, positive credit reduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!D37; effective default 0.0.","default":0},"new_construction_credit_reduction":{"type":"number","minimum":0,"description":"USD per year, positive credit reduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!E37; effective default 0.0.","default":0},"gross_equity":{"type":"number","minimum":0,"description":"USD, positive equity proceeds; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!C48; effective default 0.","default":0},"equity_bridge_interest":{"type":"number","minimum":0,"description":"USD, positive deduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!C49; effective default 0.","default":0},"equity_other_deductions":{"type":"number","minimum":0,"description":"USD, positive deduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!C52; effective default 0.","default":0}},"required":[],"additionalProperties":false},"Outputs":{"type":"object","properties":{"annual_credit_eligible":{"type":"number","description":"USD per year, eligible ceiling before a separate requested amount; calculated from publisher's workbook formulas."},"acquisition_credit":{"type":"number","description":"USD per year; calculated from publisher's workbook formulas."},"rehabilitation_credit":{"type":"number","description":"USD per year; calculated from publisher's workbook formulas."},"new_construction_credit":{"type":"number","description":"USD per year; calculated from publisher's workbook formulas."},"applicable_fraction":{"type":"number","description":"Decimal fraction 0..1, rounded to four decimal places; calculated from publisher's workbook formulas."},"effective_gross_income":{"type":"number","description":"USD per year; calculated from publisher's workbook formulas."},"operating_expenses":{"type":"number","description":"USD per year, includes replacement reserve; calculated from publisher's workbook formulas."},"budget_noi":{"type":"number","description":"USD per year, signed net income; calculated from publisher's workbook formulas."},"year_one_noi":{"type":"number","description":"USD per year; calculated from publisher's workbook formulas."},"year_one_cashflow":{"type":"number","description":"USD per year, after hard debt and mortgage insurance; calculated from publisher's workbook formulas."},"year_two_cashflow":{"type":"number","description":"USD per year; calculated from publisher's workbook formulas."},"senior_debt_service":{"type":"number","description":"USD per year; calculated from publisher's workbook formulas."},"year_one_dscr":{"type":"number","description":"Ratio; source returns zero if no hard debt; calculated from publisher's workbook formulas."},"net_equity":{"type":"number","description":"USD, signed; calculated from publisher's workbook formulas."}},"required":["annual_credit_eligible","acquisition_credit","rehabilitation_credit","new_construction_credit","applicable_fraction","effective_gross_income","operating_expenses","budget_noi","year_one_noi","year_one_cashflow","year_two_cashflow","senior_debt_service","year_one_dscr","net_equity"],"additionalProperties":false}}}}