API Data Essentiel

L’API ATIH Data Essentiel Explore v2.1 permet d’accéder de façon programmatique aux jeux de données ouverts publiés par l’Agence Technique de l’Information sur l’Hospitalisation (ATIH). Son objectif est de faciliter la consultation, l’extraction et la réutilisation des données agrégées relatives aux activités hospitalières et médico-sociales en France, sans nécessiter l’utilisation directe des interfaces graphiques du portail Data Essentiel.

Les données mises à disposition couvrent notamment les secteurs MCO (médecine, chirurgie, obstétrique), SMR (soins médicaux et de réadaptation), HAD (hospitalisation à domicile), psychiatrie, EHPAD et établissements pour personnes en situation de handicap, avec des indicateurs tels que le nombre de patients, de séjours, de journées d’hospitalisation, les pathologies, les coûts et les caractéristiques des patients.

Le périmètre est celui des données publiées sur Data Essentiel, c’est-à-dire des données généralement agrégées et en libre accès. L’API ne donne pas accès aux données individuelles ni à l’intégralité des bases brutes nationales ; certaines informations détaillées sont réservées aux plateformes Data Avancé ou Data Expert. La couverture dépend donc des jeux de données effectivement publiés par l’ATIH.

La fréquence d’actualisation varie selon les jeux de données. Certaines restitutions sont mises à jour annuellement après consolidation des bases PMSI, tandis que d’autres suivent leur propre calendrier de publication indiqué dans les métadonnées du jeu concerné.

L’API repose sur une URL de base : https://data-essentiel.atih.sante.fr/api/explore/v2.1/. Les principaux paramètres d’appel incluent généralement :

• dataset : identifiant du jeu de données ;
• select : champs à retourner ;
• where : filtre des données ;
• group_by : agrégation ;
• order_by : tri ;
• limit : nombre maximal d’enregistrements ;
• offset : pagination ;
• refine ou filtres équivalents selon le jeu de données.

Cette API est donc destinée aux analystes, statisticiens, chercheurs et développeurs souhaitant automatiser l’accès aux données ouvertes de l’ATIH et intégrer ces informations dans des outils de reporting, d’analyse ou de visualisation.