{"openapi":"3.1.0","info":{"title":"AICloseKit Contract-to-Close Engine & Settlement API","description":"Autonomous real estate contract ingestion, contingency milestone matrix calculation, party action checklists, and settlement statement auditing API.","version":"1.0.0","contact":{"name":"AICloseKit Developer Operations","email":"dev@aiclosekit.com","url":"https://aiclosekit.com"}},"servers":[{"url":"https://aiclosekit.com","description":"Production Server"}],"paths":{"/api/v1/contract/parse":{"post":{"operationId":"parse_purchase_contract","summary":"Ingest and parse executed real estate purchase contracts (FAR/BAR AS IS-6, Standard FAR/BAR)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contract_text":{"type":"string","description":"Raw plain text or OCR scan of the executed purchase contract."},"contract_terms":{"type":"object","description":"Structured contract terms if already extracted."}}}}}},"responses":{"200":{"description":"Normalized contract parameters, purchase price, deposits, and contingency days."}}}},"/api/v1/milestones/calculate":{"post":{"operationId":"calculate_transaction_milestone_matrix","summary":"Calculate strict contingency milestone deadlines under Florida FAR/BAR Standard F business day rules","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"effective_date":{"type":"string","format":"date","description":"Effective date of the contract (YYYY-MM-DD)."},"contract_terms":{"type":"object","description":"Parsed contract terms containing purchase price and contingency days."},"state":{"type":"string","default":"FL"},"county":{"type":"string","default":"Collier"}},"required":["effective_date"]}}}},"responses":{"200":{"description":"Critical date matrix adjusting for weekend and statutory holiday rolls."}}}},"/api/v1/checklist/generate":{"post":{"operationId":"generate_party_action_checklist","summary":"Generate role-specific action checklists, deadline alerts, and email templates for transaction counterparties","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"milestone_matrix":{"type":"object","description":"The computed milestone matrix."},"role":{"type":"string","enum":["Buyer Agent","Listing Agent","Title/Escrow","Lender","Buyer","Seller"],"default":"Buyer Agent"}},"required":["role"]}}}},"responses":{"200":{"description":"Itemized action checklist with ready-to-send communication templates."}}}},"/api/v1/settlement/audit":{"post":{"operationId":"audit_settlement_statement","summary":"Audit ALTA Closing Disclosure settlement statements for math accuracy, doc stamps, and fee anomalies","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contract_terms":{"type":"object","description":"Contract parameters including price, EMD, and loan amount."},"closing_statement_line_items":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string"},"amount":{"type":"number"},"type":{"type":"string","enum":["BUYER_DEBIT","BUYER_CREDIT","SELLER_DEBIT","SELLER_CREDIT"]}},"required":["description","amount","type"]}}},"required":["contract_terms","closing_statement_line_items"]}}}},"responses":{"200":{"description":"Settlement audit report with statutory tax verification and anomaly flags."}}}}}}