API Statut sportif de haut niveau et sur liste ministérielle Nouveauté
Statut sportif de haut niveau et toute catégorie inscrits en liste des collectifs nationaux ou en liste des arbitres et juges sportifs de haut-niveau.
Sport Data Hub
Périmètre
Particuliers concernés :
Cette API concerne tous les sportifs de nationalité française ou étrangère dont le statut, reconnu par le ministère des sports, est le suivant :
- ✅ les sportifs sur liste ministérielle : sportif de haut niveau (SHN), sportif inscrit en liste Espoirs (SE), sportif inscrit en liste des Collectifs Nationaux (SCN) ;
- ✅ les sportifs du parcours de performance fédéral (PPF) ;
- ✅ les arbitre-juge de haut niveau (AJSHN).
Plus d’informations sur les différents statuts et catégories des sportifs reconnu par le minstère des sports
L’API couvre les sportifs de tout âge, y compris les mineurs.
Périmètre géographique :
- ✅ France métropolitaine
- ✅ DROM COM
Actualisation de la donnée :
Les données sont mises à jour une fois par an, selon la saison sportive :
- Sports d’hiver : du 1er juillet de l’année N au 30 juin de l’année N+1 ;
- Sports d’été : du 1er janvier au 31 décembre.
Les données sont valables un an, sur l’année scolaire en général, sauf le statut du sportif de haut niveau de la catégorie élite qui est valable 2 ans.
⚠️ En conséquence, un sportif qui a concouru en novembre 2024 pour les sports d’hiver et qui est devenu sportif de haut niveau à cette période n’apparaîtra dans l’API qu’à partir de juillet 2025. Un statut demandé à un instant T peut donc être différent à un instant T+ en fonction des mises à jour. Les informations obtenues sont représentatives de la situation connue par Sport Data Hub au moment de l’appel.
Cas d'usages
Fiches pratiques et cas d'usages pour lesquels l'API est utile :
Spécifications de l'API
Format de l'information
Modalité d'appel
- Identifiant PSQS
Disponibilité
Limite d'appels
(partagé entre API du groupe)
Spécifications techniques :
Consulter le swagger Cas de tests (nouvelle fenêtre)Modalités d'appel
Cette API propose une modalité d’appel :
Identifiant PSQS
Avec l’identifiant PSQS : Identifiant utilisé pour se connecter au portail de suivi quotidien du sportif (PSQS)
Les données
Cette API délivre :
- le statut actuel du sportif ou de l’arbitre-juge : actif ou inactif ;
- la catégorie du sportif : espoir, relève, élite, senior, reconversion, collectif national, arbitre-juge ou parcours de performance fédéral ;
- les informations du club : nom, localisation, affiliation ;
- l’historique du statut : statuts précédents, catégories, clubs etc.. Les données historiques remontent à 1994 pour les listes ministerielles et à partir de 2012 pour les sportifs du Projet de performance fédéral (PPF). Ce n’est qu’à partir de 2017 que tous les sportifs du PPF ont été intégrés.
Informations renvoyées en JSON :
Les scopes
Les champs de la réponse signalés par une étiquette violette ne sont retournés que si votre jeton porte le scope correspondant. En savoir plus sur le mécanisme des scopes.
-
Identité du sportif
(sdh_statut_sportif_identite) -
Statut haut niveau
(sdh_statut_sportif_est_sportif_de_haut_niveau) -
Historique statut haut niveau
(sdh_statut_sportif_a_ete_sportif_de_haut_niveau) -
Informations statut sportif
(sdh_statut_sportif_informations_statut) -
Historique informations statut sportif
(sdh_statut_sportif_informations_statuts_precedents)
Erreurs
Lorsque cette API ne peut pas retourner les informations demandées, elle renvoie un code erreur. Les erreurs communes à toutes les API (jeton, paramètres obligatoires, quotas) sont décrites dans la nomenclature des codes erreurs ; celles qui suivent sont celles que cet endpoint peut renvoyer, y compris les erreurs génériques de son fournisseur de données.
Cette liste est aussi servie au format JSON, sans jeton, sur https://particulier.api.gouv.fr/api/errors?operation_id=api_particulier_v3_sdh_statut_sportif_with_identifiant.
| Code | Signification |
|---|---|
00380 |
Entité non traitable
L'identifiant est manquant |
| Code | Signification |
|---|---|
41003 |
Entité non trouvée
Le ou les paramètre(s) d'entrée n'existent pas, ne sont pas connus, ou ne comportent aucune information pour cet appel. Veuillez vérifier que votre recherche est couverte par le périmètre de l'API. |
| Code | Signification |
|---|---|
41000 |
Erreur interne du fournisseur de données
La réponse retournée par le fournisseur de données est invalide et a été identifié comme étant une erreur interne. Si le problème persiste, consultez la page de status ou contactez nous sur le support. |
41001 |
Service non disponible
Service du fournisseur de données temporairement indisponible ou en maintenance. |
41004 |
Erreur de résolution DNS
Problème de résolution DNS de l'adresse du serveur |
41008 |
Erreur auprès du fournisseur de données : trop de requêtes
Erreur de fournisseur de donnée : Trop de requêtes effectuées, veuillez réessayer plus tard. |
41009 |
Erreur de connexion sécurisée (TLS) avec le fournisseur de données
La connexion sécurisée avec le fournisseur de données n'a pas pu être établie : certificat invalide ou expiré, ou échec de la négociation TLS. L'équipe technique a été notifiée de cette erreur pour investigation. |
41011 |
Erreur temporaire du fournisseur de données
Merci de réessayer dans quelques instants |
41999 |
Erreur inconnue du fournisseur de données
La réponse retournée par le fournisseur de données est invalide et inconnue de notre service. L'équipe technique a été notifiée de cette erreur pour investigation. |
| Code | Signification |
|---|---|
41020 |
Maintenance du fournisseur de données
Le fournisseur de données semble être en maintenance |
| Code | Signification |
|---|---|
41002 |
Intermédiaire hors-délai
Temps d’attente d’une réponse du fournisseur de données écoulé. |
Questions & réponses
Sportifs de haut niveau (SHN). Ils sont inscrits sur la Liste des Sportifs de Haut Niveau (SHN) publiée par le ministère, et sont répartis en plusieurs sous-catégories :
Élite : Athlètes ayant obtenu des résultats exceptionnels au niveau international (Jeux Olympiques, Championnats du monde…).
Sénior : Sportifs en équipe nationale avec un potentiel pour des compétitions internationales.
Relève : Jeunes sportifs avec un fort potentiel pour accéder au plus haut niveau.
Reconversion : |
Anciens sportifs de haut niveau bénéficiant d’un accompagnement pour leur transition professionnelle.
Sportifs Espoirs : Jeunes talents identifiés comme prometteurs par leur fédération, mais n’ayant pas encore atteint le niveau international.
Sportifs des Collectifs Nationaux : Athlètes appartenant aux équipes nationales dans certaines disciplines spécifiques.
Sportifs du parcours de performance fédéral : Le Parcours de Performance Fédéral (PPF) est un programme structuré permettant d’identifier et d’accompagner les jeunes talents jusqu’au haut niveau. Ces jeunes ne sont pas encore sur liste ministérielle.
Arbitres et juges de haut niveau : Officiels qui assurent le bon déroulement des compétitions en appliquant les règles du sport concerné. Ils peuvent être :
Arbitres (sports collectifs : football, basket, rugby, handball, etc.)
Juges (sports notés : gymnastique, patinage, natation artistique, etc.)
Officiels techniques (athlétisme, escrime, haltérophilie, etc.)
Conditions d'utilisation des données
Ouverture de la donnée :
Conditions spécifiques à cette API :
Les conditions d’utilisations spécifiques à l’API
Conditions générales :
Cette API et l'utilisation de ses données sont soumises aux CGU générales d'API Particulier, dont voici les principaux éléments auxquels vous vous engagez :
- ne demander que les données strictement nécessaires ;
- ne pas utiliser votre jeton d'accès pour une démarche différente de celle indiquée lors de votre demande (le cas échéant le jeton sera révoqué) ;
- présenter les données obtenues uniquement aux seuls agents habilités et à tracer l'accès de ces agents aux données ;
- ne pas commercialiser les données reçues et à ne pas les communiquer à des tiers en dehors des cas prévus par la loi.
L'ensemble des conditions sont consultables et téléchargeables ci-dessous :
CGU API ParticulierCas d'usages
Fiches pratiques et cas d'usages pour lesquels l'API est utile :
Spécifications de l'API
Format de l'information
Modalité d'appel
- Identifiant PSQS
Disponibilité
Limite d'appels
(partagé entre API du groupe)