{"openapi":"3.1.0","info":{"title":"OHFA 2023 9% LIHTC Underwriting Model (2023)","version":"2023.1.0","description":"Ohio Housing Finance Agency 2023 9% 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-AHFA-V1.xlsx","workbookFilename":"ohfa-lihtc-9pct-2023.xlsx","workbookSha256":"7088743093d34febea9256435f67c5d8171fd22892e096882c1be061e0430011","workbookBytes":752648,"format":"xlsx","licenseClass":"reference-only"},"x-formualizer-VerificationLevel":"scenario-independent-arithmetic","x-formualizer-WorkbookDownload":{"mode":"publisher-redirect","sourceUrl":"https://ohiohome.org/ppd/documents/2023-AHFA-V1.xlsx","sha256":"7088743093d34febea9256435f67c5d8171fd22892e096882c1be061e0430011","bytes":752648},"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","vacancy","mbe_wbe_developer"],"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","mbe_wbe_developer","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","annual_credit_requested"],"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-9pct"]}},{"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":"7088743093d34febea9256435f67c5d8171fd22892e096882c1be061e0430011"},"x-workbook-bytes":{"schema":{"type":"integer"},"description":"752648"}}}}}}},"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!C244; effective default 0.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!C243; effective default 0.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!F256; 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!G282; 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!H281; 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 Housing Credits!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 Housing Credits!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.09 (blank numeric source cells act as zero).  Source location Housing Credits!D31; effective default 0.09.","default":0.09},"new_credit_rate":{"type":"number","minimum":0,"maximum":1,"description":"Annual decimal credit rate 0..1; nonnegative unless stated. Default 0.09 (blank numeric source cells act as zero).  Source location Housing Credits!E31; effective default 0.09.","default":0.09},"program":{"type":"string","enum":["","4% LIHTC","9% Competitive"],"description":"Text program switch: 4% LIHTC or 9% Competitive; activates competitive basis boost tests. Source default blank. Source location Project Details!C20; effective default .","default":""},"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 (blank numeric source cells act as zero).  Source location Budget & Costs!E83; effective default 0.","default":0},"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},"mbe_wbe_developer":{"type":"string","enum":["Yes","No"],"description":"Text enum Yes / No; Yes activates a 15% rehabilitation/new-construction basis boost when program is 9% Competitive. Default Yes. Source location Development Team!D70; effective default Yes.","default":"Yes"},"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.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!G243; effective default 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!H243; effective default 0.06.","default":0.06},"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!K243; 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!J29; 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!J30; 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 Housing Credits!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 Housing Credits!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 Housing Credits!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 Housing Credits!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 Housing Credits!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 Housing Credits!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 Housing Credits!C52; effective default 0.","default":0},"annual_credit_requested":{"type":"number","minimum":0,"description":"USD per year, request is separate from eligible ceiling; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Housing Credits!C43; effective default 0.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}}}}