{
  "openapi": "3.0.3",
  "info": {
    "title": "Mortgage and Loan Calculator API",
    "version": "1.5.1",
    "description": "Mortgage payment with PMI, refinance break-even, affordability, amortization, APR and interest. Mortgage and loan maths with the working shown: principal and interest, property tax, insurance, HOA and PMI (or FHA and VA fees) with extra-payment and biweekly savings; refinance break-even; affordability from income and debts; amortization schedules; loan, simple and compound interest with APR, solve-for and inflation-adjusted growth. Rates, taxes and insurance are your inputs: the API holds no live rate data. Estimates for information, not financial advice. Nothing you send is stored. One X-API-Key header authenticates every call, and the same key works across every FreeDailyPro API. Every 4xx response is documented and none of them is billed.",
    "contact": {
      "name": "FreeDailyPro",
      "url": "https://www.freedailypro.com/developers",
      "email": "support@freedailypro.com"
    },
    "termsOfService": "https://www.freedailypro.com/terms",
    "x-logo": {
      "url": "https://www.freedailypro.com/favicon.ico"
    }
  },
  "servers": [
    {
      "url": "https://api.freedailypro.com",
      "description": "Production"
    }
  ],
  "externalDocs": {
    "description": "Developer hub, plans and MCP setup",
    "url": "https://www.freedailypro.com/developers"
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "tags": [
    {
      "name": "Mortgage & Loans",
      "description": "Mortgage payment with PMI, refinance break-even, affordability, amortization, APR and interest."
    }
  ],
  "paths": {
    "/v1/converters/loan": {
      "post": {
        "summary": "Calculate a loan payment, with payment frequency, compounding, solve for amount, term or rate, fees and APR, deferred and zero-coupon loans",
        "operationId": "convertersLoan",
        "description": "Without any of the extra fields it is the plain monthly loan: send principal, annualRatePercent and years and get monthlyPayment, totalPayment, totalInterest, an optional schedulePreview (previewMonths up to 12) and dates (firstPaymentDate), plus a 'steps' array that shows the working. The extra fields are all optional. 'paymentFrequency' monthly (default), biweekly (every 14 days, 26 a year) or weekly (52 a year) returns the level payment for that frequency ('payment', 'numberOfPayments', 'totalInterest'; biweekly payments are re-calculated for 26 periods, they are not half of the monthly payment). 'compounding' payment (default, the standard EMI), annual, monthly, daily or continuous sets how interest compounds; the rate per payment is (1 + r/m)^(m/f) - 1. 'solveFor' amount, term or rate works backwards from a target 'payment' and the other two of principal, annualRatePercent and years (term comes back in years, rate in percent). 'fee' (an upfront fee taken out of the loan) adds 'moneyReceived' and 'apr', the annual rate at which the payments are worth exactly the money received (the actuarial method of Regulation Z, 12 CFR 1026 Appendix J; a lender's own quoted APR can differ when other charges or an odd first period apply). 'loanType' deferred returns 'dueAtMaturity' and 'interest' for a loan paid in one lump sum at the end; zeroCoupon returns the 'presentValue' (price today) of a face value paid at maturity (send the face value as principal and the yield as annualRatePercent). Who calls it: loan and mortgage comparison sites, personal-finance apps, lender and broker widgets, accounting and budgeting tools that need a payment or an APR with the working shown, and chatbots or MCP agents. Worked examples: {\"principal\":100000,\"annualRatePercent\":5,\"years\":30,\"paymentFrequency\":\"biweekly\"} returns payment 247.64 over 780 payments with 93162.51 total interest (the monthly loan is 536.82 and 93255.78); {\"principal\":10000,\"annualRatePercent\":10,\"years\":3,\"fee\":300} returns payment 322.67, moneyReceived 9700 and apr 12.1064; {\"solveFor\":\"rate\",\"payment\":536.82,\"principal\":100000,\"years\":30} returns value 5 with unit percent; {\"loanType\":\"deferred\",\"principal\":100000,\"annualRatePercent\":6,\"years\":10} returns dueAtMaturity 179084.77. Integration scenario: a comparison page shows two offers, each with a quoted rate and an origination fee; call the endpoint once per offer with the fee to show the true APR and the payment side by side. These are the same functions the FreeDailyPro website calculator runs. Pure arithmetic: no external data or tax year, nothing to update. Requests with no answer (a payment that does not cover the interest, a fee as large as the loan, a payment sent without solveFor, a field that does not apply to the loan type, compounding 'payment' for a deferred loan, an impossible date) are rejected with a 400 and a plain-words message; the API never returns NaN or Infinity. Stateless: the request is processed in memory and nothing is stored. Merged service: the same calculation is offered inside /v1/converters/loan-interest (send kind \"loan\"), which does more; this path keeps working and returns the same response as before.",
        "tags": [
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "principal": {
                    "description": "Loan amount. Required except when solveFor is 'amount'. For loanType 'zeroCoupon' it is the face value paid at maturity.",
                    "type": "number",
                    "minimum": 0
                  },
                  "annualRatePercent": {
                    "description": "Annual interest rate in percent. Required except when solveFor is 'rate'. For 'zeroCoupon' it is the yield.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "years": {
                    "description": "Term in years. Required except when solveFor is 'term'.",
                    "type": "number",
                    "maximum": 50,
                    "minimum": 0
                  },
                  "previewMonths": {
                    "description": "Number of schedule rows to return, 0 to 12 (payments, whatever the frequency).",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 12
                  },
                  "firstPaymentDate": {
                    "description": "Optional date the first payment is due, as YYYY-MM-DD. Adds a date to every schedulePreview row and returns firstPaymentDate, lastPaymentDate and payoffDate. It only labels the schedule; amounts never change. A payment on the 29th to 31st lands on the last day of shorter months.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "paymentFrequency": {
                    "description": "How often payments are made: monthly (12 a year, the default), biweekly (every 14 days, 26 a year) or weekly (52 a year).",
                    "type": "string",
                    "enum": [
                      "monthly",
                      "biweekly",
                      "weekly"
                    ]
                  },
                  "compounding": {
                    "description": "How interest compounds. 'payment' (the default) compounds on every payment, which gives the standard EMI for monthly payments. 'annual', 'monthly', 'daily' and 'continuous' use the effective rate per payment period. Deferred loans and zero-coupon bonds need annual, monthly, daily or continuous (default annual).",
                    "type": "string",
                    "enum": [
                      "payment",
                      "annual",
                      "monthly",
                      "daily",
                      "continuous"
                    ]
                  },
                  "loanType": {
                    "description": "amortized (default): level payments. deferred: nothing is paid until maturity, when principal and compounded interest are due. zeroCoupon: the price today of a bond that pays principal (the face value) at maturity at the given yield.",
                    "type": "string",
                    "enum": [
                      "amortized",
                      "deferred",
                      "zeroCoupon"
                    ]
                  },
                  "fee": {
                    "description": "Upfront fee taken out of the loan (amortized loans). Adds apr and moneyReceived to the result.",
                    "type": "number",
                    "minimum": 0
                  },
                  "solveFor": {
                    "description": "What to solve for (amortized loans). payment (default) works out the payment from amount, rate and term. amount, term or rate are solved from a target 'payment' and the other two inputs.",
                    "type": "string",
                    "enum": [
                      "payment",
                      "amount",
                      "term",
                      "rate"
                    ]
                  },
                  "payment": {
                    "description": "Target payment per period. Only with solveFor amount, term or rate.",
                    "type": "number",
                    "minimum": 0
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "principal": 250000,
                "annualRatePercent": 6.5,
                "years": 30,
                "previewMonths": 3,
                "firstPaymentDate": "2026-12-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Loan calculator client and server side from freedailypro",
                  "result": {
                    "monthlyPayment": 1580.17,
                    "totalPayment": 568861.22,
                    "totalInterest": 318861.22,
                    "schedulePreview": [
                      {
                        "month": 1,
                        "principal": 226,
                        "interest": 1354.17,
                        "balance": 249774,
                        "date": "2026-12-01"
                      },
                      {
                        "month": 2,
                        "principal": 227.23,
                        "interest": 1352.94,
                        "balance": 249546.77,
                        "date": "2027-01-01"
                      },
                      {
                        "month": 3,
                        "principal": 228.46,
                        "interest": 1351.71,
                        "balance": 249318.31,
                        "date": "2027-02-01"
                      }
                    ],
                    "firstPaymentDate": "2026-12-01",
                    "lastPaymentDate": "2056-11-01",
                    "payoffDate": "2056-11",
                    "steps": [
                      {
                        "label": "Rate per payment",
                        "formula": "annual rate / payments per year",
                        "inputs": {
                          "annual rate": "6.5%",
                          "payments per year": 12,
                          "compounding": "same as the payments"
                        },
                        "result": 0.00541667
                      },
                      {
                        "label": "Number of payments",
                        "formula": "years x payments per year",
                        "inputs": {
                          "years": 30,
                          "payments per year": 12
                        },
                        "result": 360
                      },
                      {
                        "label": "Payment",
                        "formula": "amount x i / (1 - (1 + i) ^ -n)",
                        "inputs": {
                          "amount": "250000.00",
                          "i": 0.00541667,
                          "n": 360
                        },
                        "result": "1580.17"
                      },
                      {
                        "label": "Total interest",
                        "formula": "add up the interest part of every payment",
                        "inputs": {
                          "payments": 360
                        },
                        "result": "318861.22"
                      },
                      {
                        "label": "Total paid",
                        "formula": "amount + total interest",
                        "inputs": {
                          "amount": "250000.00",
                          "total interest": "318861.22"
                        },
                        "result": "568861.22"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing required field for the chosen request, a value out of range, a field that does not apply (for example fee on a deferred loan, or payment without solveFor), a payment that never pays the loan off, a fee not smaller than the loan, or a bad firstPaymentDate; the body says which Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/compound-interest": {
      "post": {
        "summary": "Calculate the future value and interest earned with compound interest",
        "operationId": "convertersCompoundInterest",
        "description": "Calculate the future value and interest earned with compound interest. Send JSON with principal, annualRatePercent, years (required); optional: frequency, startDate. Returns JSON with principal, futureValue, totalInterest, startDate, maturityDate (inside result). Limits: annualRatePercent: at most 100; years: at most 100. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored. Merged service: the same calculation is offered inside /v1/converters/loan-interest (send kind \"compound-interest\" (it adds monthly contributions, inflation and a yearly table)), which does more; this path keeps working and returns the same response as before.",
        "tags": [
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "principal": {
                    "type": "number",
                    "minimum": 0
                  },
                  "annualRatePercent": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "years": {
                    "type": "number",
                    "maximum": 100,
                    "minimum": 0
                  },
                  "frequency": {
                    "type": "string",
                    "enum": [
                      "annually",
                      "semiannually",
                      "quarterly",
                      "monthly",
                      "daily"
                    ]
                  },
                  "startDate": {
                    "description": "Optional start date, as YYYY-MM-DD. Adds startDate and maturityDate (the date the future value is reached). It only labels the timeline; the amounts do not change.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "principal",
                  "annualRatePercent",
                  "years"
                ],
                "additionalProperties": false
              },
              "example": {
                "principal": 10000,
                "annualRatePercent": 6,
                "years": 20,
                "frequency": "monthly",
                "startDate": "2026-11-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Compound interest calculator client and server side from freedailypro",
                  "result": {
                    "principal": 10000,
                    "futureValue": 33102.04,
                    "totalInterest": 23102.04,
                    "startDate": "2026-11-01",
                    "maturityDate": "2046-11-01"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/simple-interest": {
      "post": {
        "summary": "Calculate simple interest and the total amount owed or earned",
        "operationId": "convertersSimpleInterest",
        "description": "Calculate simple interest and the total amount owed or earned. Send JSON with principal, annualRatePercent, years (required); optional: startDate. Returns JSON with principal, interest, totalAmount, startDate, maturityDate (inside result). Limits: annualRatePercent: at most 100; years: at most 100. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored. Merged service: the same calculation is offered inside /v1/converters/loan-interest (send kind \"simple-interest\"), which does more; this path keeps working and returns the same response as before.",
        "tags": [
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "principal": {
                    "type": "number",
                    "minimum": 0
                  },
                  "annualRatePercent": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "years": {
                    "type": "number",
                    "maximum": 100,
                    "minimum": 0
                  },
                  "startDate": {
                    "description": "Optional start date, as YYYY-MM-DD. Adds startDate and maturityDate (the date the total amount is reached). It only labels the timeline; the amounts do not change.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "principal",
                  "annualRatePercent",
                  "years"
                ],
                "additionalProperties": false
              },
              "example": {
                "principal": 10000,
                "annualRatePercent": 5,
                "years": 3,
                "startDate": "2026-11-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Simple interest calculator client and server side from freedailypro",
                  "result": {
                    "principal": 10000,
                    "interest": 1500,
                    "totalAmount": 11500,
                    "startDate": "2026-11-01",
                    "maturityDate": "2029-11-01"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/amortization": {
      "post": {
        "summary": "Build a loan amortization schedule with payment dates and step-by-step working",
        "operationId": "convertersAmortization",
        "description": "Build a loan amortization schedule with payment dates and step-by-step working. Send JSON with principal, annualRatePct, months (required); optional: firstPaymentDate. Returns JSON with monthlyPayment, totalPaid, totalInterest, schedule, steps, firstPaymentDate, lastPaymentDate, payoffDate (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "principal": {
                    "type": "number"
                  },
                  "annualRatePct": {
                    "type": "number",
                    "minimum": 0
                  },
                  "months": {
                    "type": "number"
                  },
                  "firstPaymentDate": {
                    "description": "Optional date the first payment is due, as YYYY-MM-DD. Adds a date to every schedule row and returns firstPaymentDate, lastPaymentDate and payoffDate. It only labels the schedule; the amounts do not change. A payment day of 29 to 31 moves to the last day of shorter months.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "principal",
                  "annualRatePct",
                  "months"
                ],
                "additionalProperties": false
              },
              "example": {
                "principal": 20000,
                "annualRatePct": 7,
                "months": 36,
                "firstPaymentDate": "2026-12-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Loan amortization schedule with optional payment dates and step-by-step working client and server side from freedailypro",
                  "result": {
                    "monthlyPayment": 617.54,
                    "totalPaid": 22231.51,
                    "totalInterest": 2231.51,
                    "schedule": [
                      {
                        "month": 1,
                        "payment": 617.54,
                        "interest": 116.67,
                        "principal": 500.88,
                        "balance": 19499.12,
                        "date": "2026-12-01"
                      },
                      {
                        "month": 2,
                        "payment": 617.54,
                        "interest": 113.74,
                        "principal": 503.8,
                        "balance": 18995.33,
                        "date": "2027-01-01"
                      },
                      {
                        "month": 3,
                        "payment": 617.54,
                        "interest": 110.81,
                        "principal": 506.74,
                        "balance": 18488.59,
                        "date": "2027-02-01"
                      },
                      "..."
                    ],
                    "steps": [
                      {
                        "label": "Monthly interest rate",
                        "formula": "Annual rate / 100 / 12",
                        "inputs": {
                          "annualRatePct": 7
                        },
                        "result": 0.00583333
                      },
                      {
                        "label": "Monthly payment",
                        "formula": "Loan amount x rate / (1 - (1 + rate) ^ -payments)",
                        "inputs": {
                          "principal": 20000,
                          "monthlyRate": 0.00583333,
                          "payments": 36
                        },
                        "result": 617.54
                      },
                      {
                        "label": "Total paid",
                        "formula": "Monthly payment x number of payments",
                        "inputs": {
                          "monthlyPayment": 617.54,
                          "payments": 36
                        },
                        "result": 22231.51
                      },
                      {
                        "label": "Total interest",
                        "formula": "Total paid - loan amount",
                        "inputs": {
                          "totalPaid": 22231.51,
                          "principal": 20000
                        },
                        "result": 2231.51
                      },
                      {
                        "label": "Split of the first payment",
                        "formula": "Interest = balance x monthly rate; principal = payment - interest",
                        "inputs": {
                          "balance": 20000,
                          "monthlyRate": 0.00583333,
                          "monthlyPayment": 617.54
                        },
                        "result": "interest 116.67, principal 500.88"
                      },
                      {
                        "label": "Payoff date",
                        "formula": "The date of the last payment: the first payment date plus (number of payments - 1) months",
                        "inputs": {
                          "firstPaymentDate": "2026-12-01",
                          "payments": 36
                        },
                        "result": "2029-11"
                      }
                    ],
                    "firstPaymentDate": "2026-12-01",
                    "lastPaymentDate": "2029-11-01",
                    "payoffDate": "2029-11"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/mortgage": {
      "post": {
        "summary": "Mortgage: monthly payment with taxes, insurance, PMI and HOA, extra payments, biweekly, payoff date, yearly table and DTI",
        "operationId": "convertersMortgage",
        "description": "Send 'homePrice', 'ratePct' and 'years' with 'downPayment' (amount) or 'downPaymentPct'. Returns 'monthly' (principal and interest, property tax from 'propertyTaxPct' or 'propertyTaxAnnual', 'homeInsuranceAnnual' as a monthly share, 'hoaMonthly', mortgage insurance and 'maintenanceAndOther'), 'payoff' (payments, total interest, total paid to lender), a 15 against 30 year 'comparison' (or your 'compareYears'), a 'biweekly' plan, and 'costGrowth' when you send 'taxGrowthPct', 'insuranceGrowthPct' or 'hoaGrowthPct'. 'loanType' conventional (PMI under 20% down, ends at 78% of the original value; override with 'pmiRatePct'), fha (upfront and annual mortgage insurance premium from the FHA table) or va ('vaUse' first or subsequent funding fee). 'extraMonthly', 'oneTimeExtra' and 'yearlyExtra' add a payoff-date and interest-saved block, with real calendar dates when 'firstPaymentDate' is sent. 'includeYearly' adds a year-by-year table. 'annualIncome' or 'monthlyIncome' with 'otherMonthlyDebts' adds the front-end and back-end debt-to-income ratios against the 28/36 guideline. Who calls it: mortgage and real-estate sites, lender and broker widgets, home-buying apps, budgeting tools, chatbots and MCP agents. Worked example: {\"homePrice\":400000,\"downPaymentPct\":20,\"ratePct\":6.5,\"years\":30,\"propertyTaxPct\":1.1,\"homeInsuranceAnnual\":1200} returns principal and interest 2,022.62, tax 366.67, insurance 100.00, total 2,489.28 a month, and 408,142.36 total interest (checked independently with the closed-form payment formula). Integration scenario: a listing page shows the all-in monthly cost for each home with the user's down payment, switching to FHA or VA with one field. Same engine as the FreeDailyPro mortgage calculator, so site and API agree. Rates, taxes and insurance are your inputs; the FHA and VA tables carry their own dates in 'sources'. Estimate, not a loan offer. Pure arithmetic from the request: no customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "homePrice": {
                    "type": "number",
                    "description": "Purchase price."
                  },
                  "downPayment": {
                    "description": "Down payment as an amount. Send this or downPaymentPct (default 20%).",
                    "type": "number"
                  },
                  "downPaymentPct": {
                    "description": "Down payment as a percent of the price.",
                    "type": "number"
                  },
                  "ratePct": {
                    "type": "number",
                    "description": "Annual interest rate in percent."
                  },
                  "years": {
                    "type": "number",
                    "description": "Term in years, 1 to 50."
                  },
                  "propertyTaxPct": {
                    "description": "Yearly property tax as a percent of the price. Send this or propertyTaxAnnual.",
                    "type": "number"
                  },
                  "propertyTaxAnnual": {
                    "description": "Yearly property tax as an amount.",
                    "type": "number"
                  },
                  "homeInsuranceAnnual": {
                    "description": "Yearly homeowners insurance.",
                    "type": "number"
                  },
                  "hoaMonthly": {
                    "description": "Monthly HOA dues.",
                    "type": "number"
                  },
                  "maintenanceMonthly": {
                    "description": "Monthly maintenance and other costs (shown in the total, left out of the debt-to-income housing figure).",
                    "type": "number"
                  },
                  "pmiRatePct": {
                    "description": "Conventional PMI rate, percent of the loan a year (default 0.6). Applies only above 80% loan-to-value and stops at 78% of the original price.",
                    "type": "number"
                  },
                  "loanType": {
                    "description": "Default conventional. FHA, VA and USDA add their standard fees (see sources in the response).",
                    "type": "string",
                    "enum": [
                      "conventional",
                      "fha",
                      "va",
                      "usda"
                    ]
                  },
                  "vaUse": {
                    "description": "VA funding fee class (VA loans only). Default first.",
                    "type": "string",
                    "enum": [
                      "first",
                      "subsequent",
                      "exempt"
                    ]
                  },
                  "extraMonthly": {
                    "description": "Extra principal paid every month.",
                    "type": "number"
                  },
                  "oneTimeExtra": {
                    "description": "One extra payment.",
                    "type": "object",
                    "properties": {
                      "month": {
                        "type": "number",
                        "description": "Payment number (1 to 600) the extra is paid with."
                      },
                      "amount": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "month",
                      "amount"
                    ],
                    "additionalProperties": false
                  },
                  "yearlyExtra": {
                    "description": "One extra payment every year.",
                    "type": "object",
                    "properties": {
                      "amount": {
                        "type": "number"
                      },
                      "month": {
                        "description": "Payment number 1 to 12 of each loan year it is paid in (default 12).",
                        "type": "number"
                      }
                    },
                    "required": [
                      "amount"
                    ],
                    "additionalProperties": false
                  },
                  "firstPaymentDate": {
                    "description": "Date of the first payment, YYYY-MM-DD. Adds the payoff dates; it only labels the schedule.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "closingCostPct": {
                    "description": "Closing costs as a percent of the price; adds closing costs and cash to close.",
                    "type": "number"
                  },
                  "annualIncome": {
                    "description": "Gross yearly income, for the debt-to-income check. Send this or monthlyIncome.",
                    "type": "number"
                  },
                  "monthlyIncome": {
                    "description": "Gross monthly income.",
                    "type": "number"
                  },
                  "otherMonthlyDebts": {
                    "description": "Other monthly debt payments (car, cards, student loans) for the back-end ratio.",
                    "type": "number"
                  },
                  "taxGrowthPct": {
                    "description": "Yearly increase of property tax in percent; any growth field adds a year-by-year costGrowth table.",
                    "type": "number"
                  },
                  "insuranceGrowthPct": {
                    "description": "Yearly increase of insurance (and maintenance) in percent.",
                    "type": "number"
                  },
                  "hoaGrowthPct": {
                    "description": "Yearly increase of HOA dues in percent.",
                    "type": "number"
                  },
                  "compareYears": {
                    "description": "The two terms to compare, default [15, 30].",
                    "type": "array",
                    "items": {}
                  },
                  "includeYearly": {
                    "description": "false leaves out the year-by-year table.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "homePrice",
                  "ratePct",
                  "years"
                ],
                "additionalProperties": false
              },
              "example": {
                "homePrice": 1,
                "ratePct": 1,
                "years": 1
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Mortgage calculator: payment with taxes, insurance, PMI and HOA, extra payments, biweekly and payoff date",
                  "result": {
                    "loanType": "conventional",
                    "loanAmount": 320000,
                    "baseLoan": 320000,
                    "financedUpfrontFee": 0,
                    "upfrontFeeLabel": null,
                    "downPayment": 80000,
                    "downPaymentPct": 20,
                    "loanToValuePct": 80,
                    "monthly": {
                      "principalAndInterest": 2022.62,
                      "propertyTax": 366.67,
                      "homeInsurance": 100,
                      "hoa": 0,
                      "mortgageInsurance": 0,
                      "mortgageInsuranceName": "PMI",
                      "maintenanceAndOther": 0,
                      "total": 2489.28,
                      "totalAfterMortgageInsuranceEnds": 2489.28
                    },
                    "mortgageInsurance": null,
                    "payoff": {
                      "payments": 360,
                      "years": 30,
                      "totalInterest": 408142.36,
                      "totalPaidToLender": 728142.36
                    },
                    "comparison": {
                      "shortYears": 15,
                      "longYears": 30,
                      "short": {
                        "payment": 2787.54,
                        "totalInterest": 181757.84
                      },
                      "long": {
                        "payment": 2022.62,
                        "totalInterest": 408142.36
                      },
                      "interestDifference": 226384.52,
                      "paymentDifference": 764.93,
                      "note": "Principal and interest only, no extra payments."
                    },
                    "biweekly": {
                      "payment": 1011.31,
                      "payments": 628,
                      "totalInterest": 314145.8,
                      "monthlyScheduleInterest": 408142.36,
                      "interestSaved": 93996.57,
                      "monthsSooner": 71,
                      "model": "Half of the monthly principal and interest every 14 days, interest at rate / 26 per period. A model: servicers that post biweekly payments only once a month save less."
                    },
                    "rulesAsOf": "2026-10-30",
                    "dataStatus": "estimate",
                    "sources": [
                      {
                        "item": "FHA mortgage insurance",
                        "rule": "Upfront 1.75% of the base loan, financed; annual MIP 0.50% or 0.55% (term over 15 years, loan-to-value up to 95% or above) and 0.15% or 0.40% (15 years or less, up to 90% or above); paid 11 years when loan-to-value is 90% or less, otherwise for the life of the loan; minimum 3.5% down",
                        "source": "HUD Mortgagee Letter 2023-05 (standard table, base loans within the FHA limit)",
                        "status": "estimate"
                      }
                    ],
                    "notes": [
                      "Conventional PMI applies while the loan is above 80% of the price and stops at 78% of the original price. FHA, VA and USDA fees follow the standard published schedules listed in sources (status: estimate)."
                    ],
                    "disclaimer": "Estimate for information only. Not financial, tax or legal advice; lenders, servicers and tax rules differ, so confirm the figures with the lender or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing or out-of-range homePrice, rate or years, a down payment sent as both amount and percent, or an unknown loanType; the body says which Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/refinance": {
      "post": {
        "summary": "Refinance break-even: monthly saving, simple and full-cost break-even month, and a net advantage table by years kept",
        "operationId": "convertersRefinance",
        "description": "Send the current loan ('currentBalance', 'currentRatePct' and 'remainingYears' or 'remainingMonths'; 'currentPayment' if you know it) and the offer ('newRatePct', 'newTermYears', 'closingCosts' or 'closingCostPct', 'financeClosingCosts' to roll the costs into the new loan). Returns both payments, 'monthlySaving', 'simpleBreakEvenMonths' (closing costs divided by the monthly saving) and 'fullCostBreakEvenMonth', which also counts the balance still owed on each loan, plus 'horizonTable' (net advantage after 1, 2, 3, 5, 7, 10 years and so on) and a plain-words 'verdict' and 'notes' (for example when the new term is longer than what is left). 'plannedYearsToKeep' adds the net advantage at that horizon. Who calls it: lender and broker tools, rate-alert and refinance-comparison sites, budgeting apps, chatbots and MCP agents. Worked example: {\"currentBalance\":300000,\"currentRatePct\":7,\"remainingYears\":28,\"newRatePct\":6,\"newTermYears\":30,\"closingCosts\":6000} returns payments 2,038.83 and 1,798.65, a saving of 240.17 a month, and break-even in month 25 (computed independently month by month). Integration scenario: a rate-alert email calls the endpoint with the user's loan and today's offer and states the break-even month. Rates and costs are your inputs; the endpoint holds no rate data. Estimate, not a loan offer. Pure arithmetic from the request: no customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "currentBalance": {
                    "type": "number",
                    "description": "What you still owe on the current loan."
                  },
                  "currentRatePct": {
                    "type": "number",
                    "description": "Current annual rate in percent."
                  },
                  "remainingYears": {
                    "description": "Years left on the current loan. Send this or remainingMonths.",
                    "type": "number"
                  },
                  "remainingMonths": {
                    "description": "Months left on the current loan.",
                    "type": "number"
                  },
                  "currentPayment": {
                    "description": "Your actual principal-and-interest payment, if you do not want it calculated from balance, rate and time left.",
                    "type": "number"
                  },
                  "newRatePct": {
                    "type": "number",
                    "description": "Annual rate of the new loan in percent."
                  },
                  "newTermYears": {
                    "type": "number",
                    "description": "Term of the new loan in years."
                  },
                  "closingCosts": {
                    "description": "Closing costs as an amount. Send this or closingCostPct.",
                    "type": "number"
                  },
                  "closingCostPct": {
                    "description": "Closing costs as a percent of the current balance.",
                    "type": "number"
                  },
                  "financeClosingCosts": {
                    "description": "true adds the closing costs to the new loan instead of paying them in cash.",
                    "type": "boolean"
                  },
                  "plannedYearsToKeep": {
                    "description": "How long you expect to keep the loan; adds a worthIt answer for that horizon.",
                    "type": "number"
                  }
                },
                "required": [
                  "currentBalance",
                  "currentRatePct",
                  "newRatePct",
                  "newTermYears"
                ],
                "additionalProperties": false
              },
              "example": {
                "currentBalance": 250000,
                "currentRatePct": 7,
                "remainingYears": 27,
                "newRatePct": 5.75,
                "newTermYears": 30,
                "closingCosts": 4000
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Refinance break-even calculator: simple and full-cost break-even, interest difference and horizon table",
                  "result": {
                    "current": {
                      "balance": 300000,
                      "ratePct": 7,
                      "payment": 2038.83,
                      "paymentsLeft": 336,
                      "totalInterestRemaining": 385045.48
                    },
                    "refinanced": {
                      "loanAmount": 300000,
                      "ratePct": 6,
                      "termMonths": 360,
                      "payment": 1798.65,
                      "totalInterest": 347514.57,
                      "closingCosts": 6000,
                      "closingCostsFinanced": false
                    },
                    "monthlySaving": 240.17,
                    "simpleBreakEvenMonths": 25,
                    "simpleBreakEvenYears": 2.08,
                    "fullCostBreakEvenMonth": 25,
                    "interestDifferenceOverLife": 37530.92,
                    "totalCostDifferenceOverLife": 31530.92,
                    "horizonTable": [
                      {
                        "years": 1,
                        "paymentsSaved": 2882.09,
                        "closingCostsPaidInCash": 6000,
                        "balanceDifference": 104.74,
                        "netAdvantage": -3013.17
                      }
                    ],
                    "verdict": "Pays back after 25 months (2.08 years) counting payments, closing costs and what is still owed; worth it only if you keep the loan longer than that.",
                    "method": "Net advantage at month m = payments saved up to m - closing costs paid in cash + (balance left on the current loan - balance left on the new loan). The simple break-even is closing costs / monthly saving.",
                    "notes": [
                      "The new term (360 payments) is longer than what is left on the current loan (336), so part of the lower payment comes from stretching the loan. Compare total interest, not only the payment."
                    ],
                    "sources": "Calculation only; no rate or fee table is used. Rates and closing costs are the figures you send.",
                    "disclaimer": "Estimate for information only. Not financial, tax or legal advice; lenders, servicers and tax rules differ, so confirm the figures with the lender or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing or out-of-range balance, rate or term, or closing costs sent as both amount and percent; the body says which Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/affordability": {
      "post": {
        "summary": "Home affordability: the home price you can afford from income and debts, with the 28/36 guideline, a stretch case and a price check",
        "operationId": "convertersAffordability",
        "description": "Send 'annualIncome' (or 'monthlyIncome'), 'otherMonthlyDebts', 'ratePct', and a 'downPayment' or 'downPaymentPct' (default 20%), with optional 'years', 'propertyTaxPct', 'homeInsuranceAnnual', 'hoaMonthly', 'pmiRatePct', 'loanType' and 'vaUse'. The largest housing payment is the smaller of the front-end limit (share of income) and the back-end limit (share of income minus other debts); the home price is the highest price whose full payment (principal and interest, tax, insurance, HOA, mortgage insurance) fits. 'guideline' uses the 28% / 36% rule, 'stretch' 31% / 43%; 'maxFrontEndPct' and 'maxBackEndPct' add a 'custom' case, and 'homePrice' adds a 'homePriceCheck' of the ratios for a house you are looking at. Each case returns the price, down payment, loan, monthly breakdown, which ratio binds and the resulting ratios. Who calls it: real-estate and mortgage sites, pre-approval widgets, budgeting apps, chatbots and MCP agents. Worked example: {\"annualIncome\":96000,\"otherMonthlyDebts\":500,\"ratePct\":6.5,\"homeInsuranceAnnual\":1200} returns a guideline payment of 2,240 (the front-end ratio binds) for a 358,266 home, and a stretch payment of 2,480 for 398,445 (verified by recomputing the payment for those prices). Integration scenario: a search page filters listings to those under the user's guideline price and flags stretch ones. The ratios are guidelines lenders use, not a lender's decision; your own rate, tax and insurance numbers drive the answer. Pure arithmetic from the request: no customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "annualIncome": {
                    "description": "Gross yearly income. Send this or monthlyIncome.",
                    "type": "number"
                  },
                  "monthlyIncome": {
                    "description": "Gross monthly income.",
                    "type": "number"
                  },
                  "otherMonthlyDebts": {
                    "description": "Other monthly debt payments (car, cards, student loans).",
                    "type": "number"
                  },
                  "downPayment": {
                    "description": "Down payment as an amount. Send this or downPaymentPct (default 20%).",
                    "type": "number"
                  },
                  "downPaymentPct": {
                    "description": "Down payment as a percent of the price.",
                    "type": "number"
                  },
                  "ratePct": {
                    "type": "number",
                    "description": "Annual mortgage rate in percent."
                  },
                  "years": {
                    "description": "Term in years (default 30).",
                    "type": "number"
                  },
                  "propertyTaxPct": {
                    "description": "Yearly property tax as a percent of the price (default 1.1).",
                    "type": "number"
                  },
                  "homeInsuranceAnnual": {
                    "description": "Yearly homeowners insurance.",
                    "type": "number"
                  },
                  "hoaMonthly": {
                    "description": "Monthly HOA dues.",
                    "type": "number"
                  },
                  "pmiRatePct": {
                    "description": "Conventional PMI rate in percent of the loan a year (default 0.6).",
                    "type": "number"
                  },
                  "loanType": {
                    "description": "Default conventional.",
                    "type": "string",
                    "enum": [
                      "conventional",
                      "fha",
                      "va",
                      "usda"
                    ]
                  },
                  "vaUse": {
                    "description": "VA funding fee class (VA loans only).",
                    "type": "string",
                    "enum": [
                      "first",
                      "subsequent",
                      "exempt"
                    ]
                  },
                  "maxFrontEndPct": {
                    "description": "Your own housing-ratio limit in percent. When either limit is sent the response has one 'custom' result instead of guideline and stretch.",
                    "type": "number"
                  },
                  "maxBackEndPct": {
                    "description": "Your own total-debt-ratio limit in percent.",
                    "type": "number"
                  },
                  "homePrice": {
                    "description": "A price to check: adds the front and back ratios and a verdict for it.",
                    "type": "number"
                  }
                },
                "required": [
                  "ratePct"
                ],
                "additionalProperties": false
              },
              "example": {
                "monthlyIncome": 8000,
                "otherMonthlyDebts": 600,
                "ratePct": 6.5,
                "years": 30,
                "downPayment": 40000
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Home affordability and debt-to-income calculator: maximum home price at the 28/36 guideline and 31/43 stretch limits",
                  "result": {
                    "grossMonthlyIncome": 8000,
                    "otherMonthlyDebts": 500,
                    "ratePct": 6.5,
                    "years": 30,
                    "loanType": "conventional",
                    "guideline": {
                      "frontLimitPct": 28,
                      "backLimitPct": 36,
                      "maxHousingPayment": 2240,
                      "binding": "housing ratio (front end)",
                      "maxHomePrice": 358266,
                      "downPayment": 71653.2,
                      "loanAmount": 286612.8,
                      "monthly": {
                        "principalAndInterest": 1811.59,
                        "propertyTax": 328.41,
                        "homeInsurance": 100,
                        "hoa": 0,
                        "mortgageInsurance": 0,
                        "total": 2240
                      },
                      "resultingFrontEndPct": 28,
                      "resultingBackEndPct": 34.25
                    },
                    "stretch": {
                      "frontLimitPct": 31,
                      "backLimitPct": 43,
                      "maxHousingPayment": 2480,
                      "binding": "housing ratio (front end)",
                      "maxHomePrice": 398445,
                      "downPayment": 79689,
                      "loanAmount": 318756,
                      "monthly": {
                        "principalAndInterest": 2014.75,
                        "propertyTax": 365.24,
                        "homeInsurance": 100,
                        "hoa": 0,
                        "mortgageInsurance": 0,
                        "total": 2480
                      },
                      "resultingFrontEndPct": 31,
                      "resultingBackEndPct": 37.25
                    },
                    "method": "Largest housing payment = the smaller of (front ratio x income) and (back ratio x income - other monthly debts). The home price is the highest price whose principal and interest, property tax, insurance, HOA and mortgage insurance fit that payment.",
                    "notes": [
                      "Guideline = 28% housing and 36% total debt; stretch = 31% and 43% (the benchmark FHA uses). Lenders also look at credit score, reserves and the loan programme, so approval can differ either way."
                    ],
                    "rulesAsOf": "2026-10-30",
                    "dataStatus": "estimate",
                    "sources": [
                      {
                        "item": "FHA mortgage insurance",
                        "rule": "Upfront 1.75% of the base loan, financed; annual MIP 0.50% or 0.55% (term over 15 years, loan-to-value up to 95% or above) and 0.15% or 0.40% (15 years or less, up to 90% or above); paid 11 years when loan-to-value is 90% or less, otherwise for the life of the loan; minimum 3.5% down",
                        "source": "HUD Mortgagee Letter 2023-05 (standard table, base loans within the FHA limit)",
                        "status": "estimate"
                      }
                    ],
                    "disclaimer": "Estimate for information only. Not financial, tax or legal advice; lenders, servicers and tax rules differ, so confirm the figures with the lender or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or out-of-range income or rate, both annualIncome and monthlyIncome, or a down payment of both amount and percent; the body says which Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/loan-interest": {
      "post": {
        "summary": "Loan and interest calculator: loan, simple interest and compound interest in one service, with APR, extra payments and inflation-adjusted growth",
        "operationId": "convertersLoanInterest",
        "description": "One endpoint for three jobs, chosen with 'kind': loan (everything the older /v1/converters/loan does: payment, APR with a fee, solveFor, paymentFrequency, compounding, deferred and zero-coupon, plus 'extraMonthly' for an early-payoff block and 'yearlySummary'), simple-interest ('principal', 'annualRatePercent', 'years'; 'compareWithCompound' adds what annual compounding would have earned) and compound-interest (adds 'frequency' annually, semiannually, quarterly, monthly or daily, 'monthlyContribution', 'contributeAtStart' and 'inflationPct' for a value in today's dollars, with a yearly balance table). The older paths /v1/converters/loan, /v1/converters/simple-interest and /v1/converters/compound-interest keep working unchanged; this one merges them. Who calls it: lender and comparison sites, savings and investing apps, education and accounting tools, chatbots and MCP agents. Worked example: {\"kind\":\"simple-interest\",\"principal\":10000,\"annualRatePercent\":5,\"years\":10,\"compareWithCompound\":true} returns 5,000 interest (total 15,000) against 16,288.95 with annual compounding, 1,288.95 more. Compound with 200 a month at 5% monthly for 10 years from 10,000 gives 47,526.55 (37,127.67 in today's dollars at 2.5% inflation); checked independently. Fields that belong to another kind are rejected rather than ignored. Pure arithmetic from the request: no customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "loan",
                      "simple-interest",
                      "compound-interest"
                    ],
                    "description": "loan: payment, schedule and solving; simple-interest; compound-interest (with regular contributions and inflation)."
                  },
                  "principal": {
                    "description": "Amount. For kind loan it is required except when solveFor is 'amount'.",
                    "type": "number",
                    "minimum": 0
                  },
                  "annualRatePercent": {
                    "description": "Annual rate in percent.",
                    "type": "number",
                    "minimum": 0
                  },
                  "years": {
                    "description": "Term in years.",
                    "type": "number",
                    "minimum": 0
                  },
                  "startDate": {
                    "description": "Interest kinds: start date, YYYY-MM-DD; adds the maturity date.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "firstPaymentDate": {
                    "description": "Loan: date of the first payment, YYYY-MM-DD; adds payment dates and the payoff date.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "previewMonths": {
                    "description": "Loan: number of schedule rows to return, 0 to 12.",
                    "type": "number",
                    "minimum": 0
                  },
                  "paymentFrequency": {
                    "description": "Loan: payment frequency (default monthly).",
                    "type": "string",
                    "enum": [
                      "monthly",
                      "biweekly",
                      "weekly"
                    ]
                  },
                  "compounding": {
                    "description": "Loan: how interest compounds (default: on every payment).",
                    "type": "string",
                    "enum": [
                      "payment",
                      "annual",
                      "monthly",
                      "daily",
                      "continuous"
                    ]
                  },
                  "loanType": {
                    "description": "Loan: amortized (default), deferred or zeroCoupon.",
                    "type": "string",
                    "enum": [
                      "amortized",
                      "deferred",
                      "zeroCoupon"
                    ]
                  },
                  "fee": {
                    "description": "Loan: upfront fee; adds the APR and money received.",
                    "type": "number",
                    "minimum": 0
                  },
                  "solveFor": {
                    "description": "Loan: what to solve for; amount, term and rate need 'payment'.",
                    "type": "string",
                    "enum": [
                      "payment",
                      "amount",
                      "term",
                      "rate"
                    ]
                  },
                  "payment": {
                    "description": "Loan: target payment per period for solveFor amount, term or rate.",
                    "type": "number",
                    "minimum": 0
                  },
                  "extraMonthly": {
                    "description": "Plain monthly loan: extra principal each month; adds interest saved and payments saved.",
                    "type": "number",
                    "minimum": 0
                  },
                  "yearlySummary": {
                    "description": "Plain monthly loan: adds a year-by-year principal, interest and balance table.",
                    "type": "boolean"
                  },
                  "frequency": {
                    "description": "Compound interest: compounding frequency (default annually).",
                    "type": "string",
                    "enum": [
                      "annually",
                      "semiannually",
                      "quarterly",
                      "monthly",
                      "daily"
                    ]
                  },
                  "monthlyContribution": {
                    "description": "Compound interest: amount added every month (needs frequency monthly).",
                    "type": "number",
                    "minimum": 0
                  },
                  "contributeAtStart": {
                    "description": "Compound interest: true adds each contribution at the start of the month instead of the end.",
                    "type": "boolean"
                  },
                  "inflationPct": {
                    "description": "Compound interest: adds the future value in today's dollars.",
                    "type": "number"
                  },
                  "compareWithCompound": {
                    "description": "Simple interest: adds the result with annual compounding for comparison.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "kind"
                ],
                "additionalProperties": false
              },
              "example": {
                "kind": "loan",
                "principal": 20000,
                "annualRatePercent": 7.5,
                "years": 5
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Loan and interest calculator: loan payments, simple interest and compound interest with contributions in one endpoint",
                  "result": {
                    "kind": "simple-interest",
                    "principal": 10000,
                    "interest": 5000,
                    "totalAmount": 15000,
                    "comparedWithAnnualCompounding": {
                      "futureValue": 16288.95,
                      "interest": 6288.95,
                      "extraInterestFromCompounding": 1288.95
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing or unknown kind, a missing principal or rate, a field that does not apply to the chosen kind, or a payment that never pays the loan off; the body says which Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    }
  }
}