ForHosting KIT · Outils pour développeurs

Estimateur Social Security

Cet estimateur de prestation Social Security convertit la moyenne mensuelle des revenus indexés en montant d’assurance primaire estimé, c’est-à-dire le chiffre mensuel obtenu avant les corrections liées à l’âge de départ.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Il répartit l’AIME entre les tranches inférieure, médiane et supérieure, applique un taux de remplacement à chacune et affiche tous les sous-totaux. Vous pouvez conserver les seuils par défaut clairement identifiés ou saisir ceux de l’année d’admissibilité concernée.

Commencez par le bon AIME et la bonne année de seuils

La moyenne mensuelle des revenus indexés, généralement appelée AIME, ne correspond ni au salaire actuel, ni au dernier salaire mensuel, ni à une simple moyenne de carrière. Le traitement du relevé Social Security indexe d’abord les revenus couverts, sélectionne les années de calcul applicables, les additionne et convertit le total en moyenne mensuelle selon les règles du régime. Cet estimateur intervient après cette opération : saisissez donc un AIME provenant d’un relevé ou d’un calcul approprié. Il ne reconstitue pas l’AIME à partir des salaires annuels. Les seuils dépendent également de l’année où la personne devient admissible pour la première fois, et non nécessairement de l’année civile de l’estimation ou de la demande de prestation. Les valeurs inférieure et supérieure proposées sont explicitement celles de 2025 : 1,226 et 7,391 dollars. Pour une autre année d’admissibilité, remplacez-les par la paire officiellement publiée. Il est essentiel d’accorder l’AIME et les seuils, car un seuil récent associé à une année antérieure peut donner un résultat vraisemblable mais faux. L’outil vérifie que le premier seuil est positif et que le second lui est supérieur.

Comprenez comment les trois taux produisent le PIA

La formule est progressive : elle remplace une plus grande part des revenus dans la première tranche que dans les suivantes. L’estimateur affecte l’AIME jusqu’au premier seuil, puis répartit le reliquat sur l’écart entre les deux seuils et place tout montant supérieur au second dans la troisième tranche. Par défaut, ces parts sont multipliées par 90, 32 et 15 pour cent. Le résultat indique le montant d’AIME et la contribution de chaque tranche, afin que vous puissiez contrôler le calcul au lieu d’accepter un chiffre opaque. Si l’AIME est inférieur au premier seuil, les contributions médiane et supérieure sont nulles. S’il se situe entre les deux, seules les deux premières tranches interviennent. Les trois contributions forment `pia_before_dime_rounding`, affiché avec les centimes à des fins d’explication. Le PIA mensuel estimé est ensuite arrondi vers le bas au dixième de dollar inférieur. Ce choix diffère d’un arrondi classique : un total brut de 2,345.67 devient 2,345.60. Les taux modifiables permettent des scénarios contrôlés, mais les valeurs standard conviennent normalement à la formule ordinaire.

Interprétez l’estimation sans en exagérer la portée

Le PIA mensuel estimé constitue une étape de formule, pas nécessairement la somme qui sera versée sur un compte. Il représente généralement le montant de départ associé à l’âge normal de la retraite avant les autres dispositions et choix de calendrier. Une demande anticipée peut réduire le versement, tandis que des crédits de retraite différée peuvent l’augmenter. Les ajustements au coût de la vie, les primes Medicare, les retenues, les plafonds familiaux, les prestations auxiliaires ou de survivant, les règles d’invalidité et certaines dispositions légales peuvent également modifier la somme réelle. Cette capacité ne modélise pas ces éléments, ne prédit aucune date de demande et ne fournit pas de conseil financier. Sa mission est plus précise : avec un AIME, deux seuils et trois taux, elle produit toujours un calcul déterministe et vérifiable par tranche. Servez-vous du détail pour contrôler une feuille de calcul, expliquer le remplacement progressif, tester une interface de planification ou comparer plusieurs années officielles. Pour une décision personnelle, vérifiez le relevé et les hypothèses auprès de sources officielles ou d’un professionnel qualifié. L’exécution sur navigateur est gratuite ; les requêtes automatisées coûtent $0.002.

Cas d’usage

Contrôler une feuille de retraite

Recalculez le PIA avec un AIME connu et les seuils de l’année d’admissibilité, puis comparez chaque tranche à votre feuille de planification.

Expliquer le remplacement progressif

Montrez comment les tranches à 90, 32 et 15 pour cent apportent des montants différents à une même prestation mensuelle estimée.

Tester une application de prestations

Utilisez l’API déterministe pour créer des résultats attendus et vérifiables destinés aux formulaires, calculateurs et logiciels pédagogiques de retraite.

Questions fréquentes

Qu’est-ce que l’AIME ?

L’AIME est la moyenne mensuelle des revenus indexés. Elle provient des revenus couverts selon les règles d’indexation et de calcul Social Security ; il ne s’agit pas simplement du dernier salaire mensuel.

Quels seuils dois-je utiliser ?

Utilisez ceux de l’année où la personne devient admissible pour la première fois selon les règles applicables. Les valeurs par défaut sont signalées comme celles de 2025 et restent modifiables.

Pourquoi le calculateur arrondit-il au dixième inférieur ?

La formule du PIA arrondit vers le bas aux dix cents inférieurs. La réponse fournit aussi le total avant arrondi pour que vous puissiez contrôler l’écart.

Le PIA mensuel estimé correspond-il à mon versement ?

Pas nécessairement. L’âge de demande, les revalorisations, les prélèvements Medicare, les retenues, les règles familiales et d’autres dispositions peuvent changer le montant réel.

Combien coûte l’estimateur ?

Vous pouvez l’utiliser gratuitement dans votre navigateur. Chaque requête API coûte $0.002 et le calcul ne sollicite aucun service réseau externe.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

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

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

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}'

const res = await fetch("https://api.kit.forhosting.com/finance/social-security-estimate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "aime": 5000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/social-security-estimate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "aime": 5000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/social-security-estimate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"aime":5000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"aime":5000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/social-security-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "aime": 5000
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.social_security_estimate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →