Skip to content
IndepAI API Docs

Calculate FI Timeline

POST
/api/v1/calculator

Calculate your Financial Independence timeline based on income, expenses, and savings. This is a public endpoint that does not require authentication but has stricter rate limits.

Request Body

Section titled “Request Body ”
object
currentAge
required

Current age in years

integer
>= 18 <= 100
Example
32
annualIncome
required

Annual gross income in base currency

number
Example
72000
annualExpenses
required

Annual expenses in base currency

number
> 0
Example
36000
currentSavings
required

Current total savings/investments in base currency

number
Example
150000
targetWithdrawalRate

Safe withdrawal rate percentage (default: 4%)

number
default: 4 >= 1 <= 10
Example
4
expectedReturn

Expected annual return percentage (default: 7%)

number
default: 7 >= -50 <= 50
Example
7
inflationRate

Expected annual inflation rate percentage (default: 2%)

number
default: 2 <= 30
Example
2
email

Optional email to associate with the calculation result

string format: email
Example
user@example.com
saveResult

Whether to save the result for analytics (default: true)

boolean
default: true
Example
true

Responses

Section titled “ Responses ”

200

Section titled “200 ”

FI calculation successful

object
success
required

Indicates successful calculation

boolean
data
required
object
fiNumber
required

Target FI amount (annual expenses × FI multiplier)

number
Example
900000
yearsToFI
required

Years until FI is reached

number
Example
12
fiDate
required

Projected date of reaching FI

string format: date-time
Example
2036-01-15T00:00:00Z
fiAge
required

Age at which FI will be reached

integer
Example
44
monthlySavings
required

Monthly savings amount

number
Example
3000
annualSavings
required

Annual savings amount

number
Example
36000
savingsRate
required

Current savings rate percentage (0-100)

number
<= 100
Example
50
currentProgress
required

Current progress toward FI percentage (0-100)

number
<= 100
Example
16.7
yearlyProjections
required

Year-by-year wealth projections

Array<object>
object
year
required

Year number (0 = current year)

integer
0
age
required

Age at this year

integer
Example
32
netWorth
required

Projected net worth at end of year

number
Example
150000
totalContributions
required

Cumulative contributions

number
Example
150000
totalGains
required

Cumulative investment gains

number
0
progressPercent
required

Percentage progress toward FI Number

number
<= 100
Example
16.7
fiReached
required

Whether FI has been reached this year

boolean
inputs
required

Input parameters used for calculation

object
age
required
number
annualIncome
required
number
annualExpenses
required
number
currentSavings
required
number
monthlyPassiveIncome
required
number
expectedReturn
required
number
inflationRate
required
number
fiMultiplier
required
number
meta
required
object
timestamp
required

Response timestamp

string format: date-time
version
required

API version

string
Example
1.0

400

Section titled “400 ”

Validation error

object
success
required

Always false for error responses

boolean
error
required

Error type

string
Example
Validation error
code

Machine-readable error code

string
Example
VALIDATION_ERROR
details

Detailed validation errors

Array<object>
object
path
required

Path to the invalid field

string
Example
currentAge
message
required

Error message

string
Example
Must be between 18 and 100

429

Section titled “429 ”

Rate limit exceeded

object
success
required

Always false for error responses

boolean
error
required

Error type

string
Example
Validation error
code

Machine-readable error code

string
Example
VALIDATION_ERROR
details

Detailed validation errors

Array<object>
object
path
required

Path to the invalid field

string
Example
currentAge
message
required

Error message

string
Example
Must be between 18 and 100