GuidesAPI Reference
Log In
API Reference

/participants/{participant_id}/retirement-planning-estimate/

Estimate a participant's projected balance and target savings for retirement. Will use the defaults as defined
from the retirement-planning-defaults unless an override is given. Can only be used if the participant has not
yet reached retirement, or the supplied age is less than retirement_age.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Query Params
integer
18 to 115

Defaults to participant's age

string
^-?\d{0,3}(?:\.\d{0,2})?$
Defaults to 2.00

Expected annual raise

boolean
Defaults to true

Display amounts as they are worth today

integer
≥ 0

Defaults to participant's current account balance

boolean
Defaults to true

Include employer contributions to the account

boolean
Defaults to true
string
^-?\d{0,3}(?:\.\d{0,2})?$
Defaults to 2.00

Expected annual inflation

string
^-?\d{0,3}(?:\.\d{0,2})?$
Defaults to 5.00

Expected annual investment return

integer
Defaults to 90
integer
18 to 115

Defaults to participant's retirement age

string
^-?\d{0,3}(?:\.\d{0,2})?$
Defaults to 70.00

Percentage of income needed during retirement

integer
≥ 0

Defaults to participant's previous year compensation or estimation based on this year

string
^-?\d{0,3}(?:\.\d{0,2})?$

Percentage of income saved

Responses

400

Bad Request: invalid supplied data

401

Unauthorized: Missing or invalid authentication

403

Forbidden: Insufficient permissions or scopes

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json