HappyApi

HappyApi

Une API pour calculer la clé d'un numéro de sécurité sociale en ligne

Cette API, ce webservice vous permet de calculer la clé d'un numéro de sécurité sociale.

Les valeurs à passer à l'API

Le n° de sécurité sociale à vérifier

Le retour de l'API

La clé du numéro de sécurité sociale
Résultat :

Quel est le numéro de sécurité sociale à vérifier ?
Réponse :

Codes erreur possibles :
  • -1 : La taille doit être de 13 caractères minimum et 15 maximum
  • -2 : Ne doit contenir que des chiffres
  • -3 : Doit commencer par un 1 ou un 2
  • -99 : Quota de requêtes dépassé
  • Code d'erreur (0 = aucune erreur) :  
    Temps d'execution (ms) :  
    Commande curl

    Comment est calculée la clé d'un numéro de sécurité sociale ?

    Le numéro NIR (Numéro d'Inscription au Répertoire) est un numéro unique qui est identique au numéro de sécurité sociale. C'est l'INSEE qui est chargée d'attribuer ce numéro. On parle aussi du numéro INSEE.
    Ce numéro sert d'identifiant unique pour chaque individu.
    La clé du numéro de sécurité sociale est constituée de 2 chiffres et est comprise entre 01 et 97. Elle permet de vérifier la validité des 13 chiffres du numéro, grâce à un algorithme qui lui est appliqué.

    Algorithme de calcul de la clé du numéro de sécurité sociale

    Cette clé est calculée par une formule mathématique. Elle s'applique sur des valeurs numériques. En ce qui concerne les départements de la corse, il faut alors remplacer les lettres présentes dans les départements corses :2A va devenir 19 et 2B devient 18.
    La clé peut alors être calculée avec la formule suivante :

    Clé du numéro de sécurité sociale = 97 - ( ( Valeur numérique du numéro de sécurité sociale ) modulo 97 )
    Concepteur de l'API : Jérôme SAVAJOLS LinkedIn