Payback period calculator API

Payback period = initialInvestment / annualCashFlow for even flows, or the cumulative-crossing point (with fractional interpolation) for uneven cashFlows — the classic capital-budgeting recovery metric. Answers 'how long to recoup this investment', 'when does cumulative cash flow turn positive', 'what's the payback period'.

Price$0.01per request

MethodPOST

Route/v1/calc/biz-payback-period

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcpaybackcapital-budgetinginvestmentcash-flowopsfinancerecovery

API URLhttps://x402.hexl.dev/v1/calc/biz-payback-period

Integration docs

Example request

{
  "initialInvestment": 50000,
  "annualCashFlow": 12500
}

Example response

{
  "formula": "payback = initialInvestment / annualCashFlow",
  "mode": "even",
  "paybackPeriod": 4,
  "recovered": true,
  "rating": "moderate",
  "inputs": {
    "initialInvestment": 50000,
    "annualCashFlow": 12500
  }
}

Input schema

{
  "type": "object",
  "required": [
    "initialInvestment"
  ],
  "properties": {
    "initialInvestment": {
      "type": "number",
      "examples": [
        50000
      ]
    },
    "annualCashFlow": {
      "type": "number",
      "examples": [
        12500
      ]
    },
    "cashFlows": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "examples": [
        [
          10000,
          10000,
          20000
        ]
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}