ForHosting KIT · Developer Utilities

Social Security benefit estimator

This Social Security benefit estimator turns average indexed monthly earnings into an estimated primary insurance amount, the monthly figure produced before adjustments for the age at which benefits begin.

● BetaFree · in your browser
Use it from WebAPIEmailTelegramApp soon

It divides AIME across the lower, middle, and upper formula tiers, applies a replacement percentage to each portion, and shows every subtotal. You can keep the clearly labeled default bend points or enter the values for the worker's applicable eligibility year, making the result transparent and repeatable rather than a hidden black-box estimate.

Start with the right AIME and bend-point year

Average indexed monthly earnings, usually shortened to AIME, is not the same as current pay, a recent monthly paycheck, or a simple career average. The Social Security earnings-record process first indexes covered earnings, selects the applicable computation years, totals them, and converts that total into a monthly average under program rules. This estimator begins after that process, so enter an AIME obtained from an appropriate record or calculation. It does not reconstruct AIME from annual wages. Bend points also depend on the year a worker first becomes eligible, not necessarily the calendar year in which the estimate is requested or benefits are claimed. The included lower and upper defaults are explicitly the 2025 values: 1,226 dollars and 7,391 dollars. For another eligibility year, replace both values with the officially published pair for that year. Keeping AIME and bend points aligned matters because using a current bend point with an older eligibility year can produce a plausible-looking but incorrect result. The calculator validates that the lower point is positive and the upper point is larger, helping catch reversed entries before any benefit is shown.

See how the three replacement tiers create PIA

The formula is progressive: it replaces a larger share of earnings in the first tier than in later tiers. The estimator allocates AIME through the first bend point, then allocates any remaining AIME through the distance between the first and second points, and finally places any amount above the second point in the third tier. By default, those portions are multiplied by 90 percent, 32 percent, and 15 percent. The result includes each tier's AIME amount and benefit contribution, so the arithmetic can be reviewed instead of merely accepted. If AIME is below the first bend point, the middle and upper contributions are zero. If it falls between the points, only the first and middle tiers contribute. The three contributions are added to produce `pia_before_dime_rounding`, shown to cents for explanation. The official-style estimated monthly PIA is then rounded downward to the next lower dime. That is intentionally different from conventional nearest-cent or nearest-dollar rounding: a raw total of 2,345.67 becomes 2,345.60. Editable percentages support controlled scenarios, but the standard defaults should generally remain unchanged when estimating the ordinary worker formula.

Interpret the estimate without overstating it

The estimated monthly PIA is a formula checkpoint, not necessarily the amount that will arrive in a bank account. PIA is generally the starting amount associated with full retirement age before other provisions and timing choices are applied. Claiming retirement benefits early can reduce the payable amount, while delayed retirement credits can increase it. Cost-of-living adjustments, Medicare premiums, withholding, family maximum rules, auxiliary or survivor benefits, disability rules, and special statutory provisions can also change real payments. This capability does not model those layers, predict a claiming date, or offer financial advice. Its strength is narrower: given AIME, two bend points, and three rates, it produces a deterministic and auditable tier calculation every time. Use the tier breakdown to verify a spreadsheet, teach how progressive replacement works, test a benefits-planning interface, or compare calculations made with different officially published bend-point years. For a personal decision, confirm the earnings record and eligibility assumptions with official resources or a qualified professional. The browser version is free, while automated requests cost $0.002; both execute the same pure calculation without sending data to a third-party service.

Check a retirement worksheet

Recalculate PIA from a known AIME and eligibility-year bend points, then compare each tier with a spreadsheet or planning worksheet.

Explain progressive replacement

Show how the 90, 32, and 15 percent tiers contribute different amounts to one estimated monthly benefit.

Test a benefits application

Use the deterministic API to generate auditable expected values for forms, calculators, and educational retirement-planning software.

What is AIME?

AIME means average indexed monthly earnings. It is derived from a worker's covered earnings under Social Security indexing and computation rules; it is not simply the latest monthly wage.

Which bend points should I use?

Use the bend points for the year the worker first becomes eligible under the applicable program rules. The defaults are labeled as 2025 values and can be replaced.

Why does the calculator round down to a dime?

The PIA formula applies downward rounding to the next lower ten cents. The response also includes the pre-rounding total so you can audit the difference.

Is estimated monthly PIA my expected check?

Not necessarily. Claiming age, cost-of-living adjustments, Medicare deductions, withholding, family provisions, and other rules may change an actual payable benefit.

How much does the estimator cost?

It is free to run in the browser. Each API request costs $0.002, and the calculation uses no external network service.

Everything on this page is available programmatically. This section is for teams who want to wire it into their own systems; everyone else can just use the tool above.

POSThttps://api.kit.forhosting.com/finance/social-security-estimate

Prefer to automate it? One authenticated POST creates the task; the result comes back by webhook or a signed link. The same capability also runs here on the web, by email and from Telegram — and soon from our app too.

curl -X POST https://api.kit.forhosting.com/finance/social-security-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"aime":5000}'
{
  "aime": 5000
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.social_security_estimate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

The API is asynchronous: the call returns a task_id immediately and the result arrives by webhook. Polling is capped at 1 req/s per task.

Per request$0.002

Published price — no tokens, no invented credits. A failed task is never charged.

HTTPCodeMeaning
401unauthorizedMissing or invalid API key.
402insufficient_balanceYour balance doesn't cover the task price.
404unknown_typeThat task type doesn't exist.
429rate_limitedToo many requests. Use the webhook instead of polling.

Read the full KIT documentation →