# Posos Public Documentation

> Bilingual (French/English) documentation for the Posos Public APIs and Medical Database. Every page is available as clean markdown by appending `.md` to its URL. Pages and sections marked 🔒 require a valid authenticated access — their markdown is served only to authorized requests.

## Documentation (français)

- [Posos Healthcare Platform](/docs/fr.md)
- [À propos](/docs/fr/about.md)
- [Catalogue des APIs](/docs/fr/apis/api-catalog.md): Vue d'ensemble des APIs Posos documentées, de leurs endpoints et de leur disponibilité régionale
- [Authentification sécurisée sur l’API POSOS](/docs/fr/apis/authentication_google.md): Documentation de l'authentification sécurisée sur l'API POSOS (Legacy)
- [Authentification sécurisée sur l’API POSOS](/docs/fr/apis/authentication.md): Documentation de l'authentification sécurisée sur l'API POSOS
- [Pipeline d'analyse clinique](/docs/fr/apis/concepts/clinical-analysis-pipeline.md): Comprendre les trois services backend qui alimentent les APIs d'analyse clinique Posos
- [Identification des médicaments](/docs/fr/apis/concepts/drug-identification.md): Comment les médicaments sont codés et identifiés dans les APIs Posos
- [Bienvenue sur la documentation Posos](/docs/fr/apis/getting-started.md)
- [Introduction](/docs/fr/apis/guides/cds-hooks.md): Utilisation de l'API CDS Hooks de Posos
- [API d'analyse d'ordonnance](/docs/fr/apis/guides/drugs-analysis.md): Ces APIs permettent de détecter des problèmes liés aux médicaments pris par un patient et de proposer des traitements alternatifs.
- [Entrepôt FHIR](/docs/fr/apis/guides/fhir-server-old.md): Guide de démarrage sur l'utilisation de l'entrepôt FHIR de Posos
- [Entrepôt FHIR](/docs/fr/apis/guides/fhir-server.md): Guide de démarrage sur l'utilisation de l'entrepôt FHIR de Posos
- [Intégration du scan d'ordonnance](/docs/fr/apis/guides/integration-scan.md): Guide d'intégration de la retranscription automatique d'ordonnance
- [Appels contextuels](/docs/fr/apis/guides/partner-connect.md): Guide de démarrage pour l'intégration des appels contextuels, permettant d'accéder à une fonctionnalité de Posos sans authentification
- [Import de prescription](/docs/fr/apis/guides/prescription-import.md): Guide de démarrage de l'import de prescription
- [Appels des APIs](/docs/fr/apis/guides/using-our-apis.md): Plusieurs APIs sont à disposition afin de récupérer ou structurer des données médicales.
- [Death Cause](/docs/fr/apis/reference/death-cause.md): Classification des causes de décès dans la terminologie CIM-10 (ICD-10), à 2 chiffres de précision.
- [Serveur MCP Posos](/docs/fr/apis/reference/mcp.md): Le serveur MCP Posos permet aux assistants IA d'accéder aux APIs médicales Posos (analyse d'ordonnance, base de données médicale, autocomplétion) via le protocole MCP.
- [Accès au dashboard de l'utilisateur (BPM)](/docs/fr/apis/reference/partner-connect/bpm/access-dashboard.md): API permettant d'accéder au tableau de bord des entretiens pharmaceutiques de l'utilisateur
- [Accès à l'entretien pharmaceutique (BPM)](/docs/fr/apis/reference/partner-connect/bpm/access-review.md): API permettant d'accéder à l'entretien pharmaceutique pour un patient au travers d'un appel contextuel
- [Création d'un entretien pharmaceutique (BPM)](/docs/fr/apis/reference/partner-connect/bpm/create-review.md): API permettant d'initialiser un accompagnement pharmaceutique, comme un bilan partagé de médication pour un patient
- [Accès à l'entretien pharmaceutique (BPM)](/docs/fr/apis/reference/partner-connect/bpm/get-review-infos.md): API permettant d'accéder à l'entretien pharmaceutique pour un patient au travers d'un appel contextuel
- [Appel contextuel vers Posos](/docs/fr/apis/reference/partner-connect/proxy-prepare.md): API permettant d'effectuer un appel contextuel vers les differentes fonctionnalités de Posos, organisées en guides
- [QR Code](/docs/fr/apis/reference/partner-connect/qr-code.md): API permettant d'intégrer dans n’importe quelle page HTML un QR Code contenant un identifiant technique de dossier patient.
- [Scan & Go](/docs/fr/apis/reference/partner-connect/scan-go.md): API permettant de récupérer un URL vers une interface complète d’import et de validation de la prescription.
- [Scan d'ordonnance](/docs/fr/apis/reference/prescription-scan.md): API d'analyse d'ordonnance, permettant de récupérer les informations contenues dans une forme structurée (FHIR).
- [Configuration requise](/docs/fr/apis/required-configuration.md): Configuration requise pour utiliser les APIs Posos
- [Accès non autorisé](/docs/fr/unauthorized.md)

### Restricted — authentication required 🔒

- 🔒 [Régions et marchés](/docs/fr/apis/concepts/regions.md): Comparaison France et Belgique : paramètres régionaux, terminologies et fonctionnalités des APIs Posos.
- 🔒 [GraphiQL AAE](/docs/fr/apis/reference/analysis/aae-playground.md)
- 🔒 [Analyse des effets indésirables](/docs/fr/apis/reference/analysis/adverseeffects.md): API permettant de vérifier l'inputabilité des médicaments sur les effets indésirables, et de lister l'ensemble des effets indésirables provoqués par des médicaments.
- 🔒 [Allergies](/docs/fr/apis/reference/analysis/allergy.md): API permettant de détecter les allergies
- 🔒 [Recommandations de Traitements](/docs/fr/apis/reference/analysis/alternatives.md): API permettant de recommander des traitements pour une indication.
- 🔒 [GraphiQL AORT](/docs/fr/apis/reference/analysis/analysis-playground.md)
- 🔒 [Charge anticholinergique](/docs/fr/apis/reference/analysis/anticholinergic-loads.md): API calculant la charge anticholinergique d'une liste de médicaments, par médicament et en somme, sur une ou plusieurs échelles de score.
- 🔒 [Critères biologiques](/docs/fr/apis/reference/analysis/biological-criteria.md): API listant les critères biologiques nécessaires à l'analyse d'un ensemble de médicaments.
- 🔒 [Calculateurs](/docs/fr/apis/reference/analysis/calculators.md): API permettant d'effectuer des calculs.
- 🔒 [Marquage CE](/docs/fr/apis/reference/analysis/certificate.md)
- 🔒 [Analyse de contre-indications](/docs/fr/apis/reference/analysis/contraindications.md): API permettant de vérifier l'absence ou la présence de contre-indications pour un médicament.
- 🔒 [Alertes de posologie](/docs/fr/apis/reference/analysis/dosage-alert.md): API permettant de récupérer les alertes de posologie pertinentes.
- 🔒 [Unités de prise](/docs/fr/apis/reference/analysis/dosage-units.md): API permettant de récupérer les unités de prise de médicaments pour la prescription
- 🔒 [GraphiQL ARP](/docs/fr/apis/reference/analysis/dosages-playground.md)
- 🔒 [Ajustement posologique](/docs/fr/apis/reference/analysis/dose-adjustment.md): API permettant de vérifier l'éligibilité d'un médicament à un ajustement posologique, de calculer une combinaison de spécialités atteignant une dose cible, et de calculer la quantité de substance active par période
- 🔒 [Recommandations de traitement](/docs/fr/apis/reference/analysis/guides/alternatives.md): Ce guide vous accompagne pas à pas pour utiliser l'API getAlternatives afin de recommander des traitements personnalisés pour une indication clinique.
- 🔒 [Indications](/docs/fr/apis/reference/analysis/indications.md): API listant les indications cliniques d'un ensemble de médicaments, prêtes à être transmises aux endpoints qui filtrent par indication.
- 🔒 [Analyse d'interactions](/docs/fr/apis/reference/analysis/interactions.md): API permettant de vérifier l'absence ou la présence d'interactions pour un médicament.
- 🔒 [Étiquette du dispositif médical](/docs/fr/apis/reference/analysis/medical-device-label.md): API permettant trouver les informations administratives de l'étiquette du dispositif médical.
- 🔒 [Analyse des compatibilités physico-chimiques](/docs/fr/apis/reference/analysis/physico-chemical-compatibilities.md): API permettant de vérifier l'absence ou la présence de compatibilités physico-chimiques au sein d'une prescription'.
- 🔒 [Critères post-arrêt](/docs/fr/apis/reference/analysis/post-stop-criteria.md): API listant, pour chaque médicament portant des données post-arrêt, la durée d'activité pharmacologique résiduelle et les dimensions d'analyse concernées.
- 🔒 [Coûts de prescription](/docs/fr/apis/reference/analysis/prescription-cost.md): API permettant d'obtenir les coûts de prescription d'une ordonnance.
- 🔒 [Conditions de prescription](/docs/fr/apis/reference/analysis/restricted-prescriptions.md): API permettant trouver les conditions de prescription des médicaments d'une prescription.
- 🔒 [Système d'aide à la décision indexé par médicament (HAS)](/docs/fr/apis/reference/analysis/sam.md): API permettant de vérifier l'absence ou la présence d'alertes de la SAM pour un médicament.
- 🔒 [Redondance thérapeutique](/docs/fr/apis/reference/analysis/therapeutic-duplication.md): API permettant de détecter les redondances thérapeutiques entre différents médicaments
- 🔒 [Analyse de document](/docs/fr/apis/reference/documents/analysis.md): Analyse un compte rendu hospitalier, en texte ou en fichier, et renvoie les entités cliniques codées, les sections, le type de document et les éléments à intégrer au dossier patient.
- 🔒 [Réconciliation du dossier patient](/docs/fr/apis/reference/documents/reconciliation.md): Compare les éléments extraits d'un document médical avec le dossier patient (Bundle FHIR R4), propose une action par élément et produit le Bundle de transaction des modifications retenues.
- 🔒 [Autocomplétion](/docs/fr/apis/reference/nlp/autocomplete.md): API permettant de récupérer une liste d'entités médicales (principes actifs, spécialités, indications, des contre-indications, etc.) correspondant à une requête.
- 🔒 [NERL](/docs/fr/apis/reference/nlp/nerl.md): API permettant d'extraire et de lier des entités médicales (médicaments, posologies, indications, etc.) à partir d'un texte.
- 🔒 [Reconstruction de posologie](/docs/fr/apis/reference/nlp/posology-reconstruction.md): API de reconstruction de posologie textuelle
- 🔒 [Structuration de posologie](/docs/fr/apis/reference/nlp/posology.md): API de structuration de posologie médicale
- 🔒 [Posologies complexes (detect_complex_posology)](/docs/fr/apis/reference/nlp/prescription-scan-complex-posology.md): Nouveautés du bundle FHIR lorsque l'option detect_complex_posology est activée sur le scan d'ordonnance — perfusions, phases datées, plafonds de dose, renouvellements.
- 🔒 [Structuration de prescription](/docs/fr/apis/reference/nlp/prescription.md): API permettant d'analyser une prescription médicale complète et d'en extraire les éléments prescrits (médicaments, dispositifs médicaux, posologies).
- 🔒 [Playground API](/docs/fr/apis/reference/playground.md): Playground interactif pour tester une sélection d'endpoints NLP et d'analyse clinique.
- 🔒 [Modèle FHIR de la prescription](/docs/fr/apis/types/fhir-prescription-model.md): Description du modèle FHIR de la prescription
- 🔒 [Modèle de posologie structurée (ancien)](/docs/fr/apis/types/posology-model-internal.md): Description du modèle de la posologie structurée interne du NERL
- 🔒 [Modèle de posologie structurée](/docs/fr/apis/types/posology-model.md): Description du modèle de la posologie structurée
- 🔒 [Types d'entrée partagés](/docs/fr/apis/types/shared-input-types.md): Types d'entrée GraphQL communs utilisés dans les APIs d'analyse clinique
- 🔒 **MedicalDB** — section requires a valid access (pages not listed)
- 🔒 **Widgets** — section requires a valid access (pages not listed)

## Documentation (English)

- [Posos Healthcare Platform](/docs/en.md)
- [About](/docs/en/about.md)
- [API Catalog](/docs/en/apis/api-catalog.md): Overview of documented Posos APIs, endpoints, and regional availability
- [Secure authentication on POSOS API](/docs/en/apis/authentication_google.md): Documentation of secure authentication on Posos API
- [Secure authentication on POSOS API](/docs/en/apis/authentication.md): Documentation of secure authentication on Posos API
- [Clinical Analysis Pipeline](/docs/en/apis/concepts/clinical-analysis-pipeline.md): Understanding the three backend services powering Posos clinical analysis APIs
- [Drug Identification](/docs/en/apis/concepts/drug-identification.md): How drugs are coded and identified across Posos APIs
- [Welcome to Posos documentation](/docs/en/apis/getting-started.md)
- [Introduction](/docs/en/apis/guides/cds-hooks.md): Using the Posos CDS Hooks API
- [Prescription analysis API](/docs/en/apis/guides/drugs-analysis.md): These APIs make it possible to detect problems related to medications taken by a patient and to propose alternative treatments.
- [FHIR Warehouse](/docs/en/apis/guides/fhir-server-old.md): Getting started guide for using the Posos FHIR warehouse
- [FHIR Warehouse](/docs/en/apis/guides/fhir-server.md): Getting started guide for using the Posos FHIR warehouse
- [Order scan integration](/docs/en/apis/guides/integration-scan.md): Integration guide for automatic prescription transcription
- [Contextual calls](/docs/en/apis/guides/partner-connect.md): Getting started guide for the integration of contextual calls, allowing access to Posos functionality without authentication
- [Prescription import](/docs/en/apis/guides/prescription-import.md): Prescription import getting started guide
- [API calls](/docs/en/apis/guides/using-our-apis.md): Several APIs are available to retrieve or structure medical data.
- [Posos MCP Server](/docs/en/apis/reference/mcp.md): The Posos MCP server allows AI assistants to access Posos medical APIs (prescription analysis, medical database, autocomplete) via the MCP protocol.
- [Contextual call to Posos](/docs/en/apis/reference/partner-connect/proxy-prepare.md): API allowing you to make a contextual call to the different Posos functionalities, organized in guides
- [QR Code](/docs/en/apis/reference/partner-connect/qr-code.md): API allowing you to integrate a QR Code containing a technical patient file identifier into any HTML page.
- [Scan & Go](/docs/en/apis/reference/partner-connect/scan-go.md): API allowing you to retrieve a URL to a complete prescription import and validation interface.
- [Prescription scan](/docs/en/apis/reference/prescription-scan.md): Prescription analysis API, allowing information contained in a structured form (FHIR) to be retrieved.
- [Required configuration](/docs/en/apis/required-configuration.md): Requirements to use Posos APIs
- [Unauthorized access](/docs/en/unauthorized.md)

### Restricted — authentication required 🔒

- 🔒 [Regions and markets](/docs/en/apis/concepts/regions.md): France and Belgium compared: regional parameters, terminologies and Posos API features.
- 🔒 [GraphiQL AAE](/docs/en/apis/reference/analysis/aae-playground.md)
- 🔒 [Adverse effects analysis](/docs/en/apis/reference/analysis/adverseeffects.md): API to check the inputability of drugs for adverse effects, and to list all adverse effects caused by drugs.
- 🔒 [Allergy](/docs/en/apis/reference/analysis/allergy.md): API allowing you to detect allergies.
- 🔒 [Treatment Recommendations](/docs/en/apis/reference/analysis/alternatives.md): API for recommending treatments for an indication.
- 🔒 [GraphiQL AORT](/docs/en/apis/reference/analysis/analysis-playground.md)
- 🔒 [Anticholinergic load](/docs/en/apis/reference/analysis/anticholinergic-loads.md): API computing the anticholinergic load of a list of drugs, per drug and as a sum, on one or more scoring scales.
- 🔒 [Biological criteria](/docs/en/apis/reference/analysis/biological-criteria.md): API listing the biological lab criteria required to analyze a set of drugs.
- 🔒 [Calculators](/docs/en/apis/reference/analysis/calculators.md): API allowing you to perfoms calculations.
- 🔒 [CE Marking](/docs/en/apis/reference/analysis/certificate.md)
- 🔒 [Analysis of contraindications](/docs/en/apis/reference/analysis/contraindications.md): API allowing you to check the absence or presence of contraindications for a drug.
- 🔒 [Dosage alerts](/docs/en/apis/reference/analysis/dosage-alert.md): API to retrieve relevant dosage alerts.
- 🔒 [Dosage units](/docs/en/apis/reference/analysis/dosage-units.md): API to retrieve the dosage units of medications for a prescription.
- 🔒 [GraphiQL ARP](/docs/en/apis/reference/analysis/dosages-playground.md)
- 🔒 [Dose Adjustment](/docs/en/apis/reference/analysis/dose-adjustment.md): API for checking whether a drug is eligible for dose adjustment, computing a combination of presentations reaching a target dose, and computing the active substance quantity per period
- 🔒 [Indications](/docs/en/apis/reference/analysis/indications.md): API listing the clinical indications of a set of drugs, ready to be forwarded to the endpoints that filter by indication.
- 🔒 [Interaction analysis](/docs/en/apis/reference/analysis/interactions.md): API allowing you to check the absence or presence of interactions for a drug.
- 🔒 [Medical device label](/docs/en/apis/reference/analysis/medical-device-label.md): API to retrieve the informations on the medical device label.
- 🔒 [Physico-chemical Compatibility Analysis](/docs/en/apis/reference/analysis/physico-chemical-compatibilities.md): API to check for the absence or presence of physico-chemical compatibilities within a prescription.
- 🔒 [Post-stop criteria](/docs/en/apis/reference/analysis/post-stop-criteria.md): API listing, for each drug carrying post-stop data, the residual pharmacological activity duration and the analysis dimensions it applies to.
- 🔒 [Prescription cost](/docs/en/apis/reference/analysis/prescription-cost.md): API to retrieve the prescription conditions of medications in a prescription.
- 🔒 [Prescription Conditions](/docs/en/apis/reference/analysis/restricted-prescriptions.md): API to retrieve the prescription conditions of medications in a prescription.
- 🔒 [Drug-Indexed Decision Support System (HAS)](/docs/en/apis/reference/analysis/sam.md): API to check for the presence or absence of SAM alerts for a drug.
- 🔒 [Therapeutic Duplication](/docs/en/apis/reference/analysis/therapeutic-duplication.md): API for detecting therapeutic duplications between different medications
- 🔒 [Document analysis](/docs/en/apis/reference/documents/analysis.md): Analyzes a hospital report, as text or as a file, and returns coded clinical entities, sections, the document type and the items to add to the patient record.
- 🔒 [Patient record reconciliation](/docs/en/apis/reference/documents/reconciliation.md): Compares the items extracted from a medical document with the patient record (FHIR R4 Bundle), proposes an action per item and produces the transaction Bundle of the selected changes.
- 🔒 [Autocompletion](/docs/en/apis/reference/nlp/autocomplete.md): API allowing you to retrieve a list of medical entities (active ingredients, specialties, indications, contraindications, etc.) corresponding to a query.
- 🔒 [NERL](/docs/en/apis/reference/nlp/nerl.md): API for extracting and linking medical entities (drugs, dosages, indications, etc.) from text.
- 🔒 [Dosage reconstruction](/docs/en/apis/reference/nlp/posology-reconstruction.md): Textual dosage reconstruction API
- 🔒 [Dosage structuring](/docs/en/apis/reference/nlp/posology.md): Medical Dosage Structuring API
- 🔒 [Complex posologies (detect_complex_posology)](/docs/en/apis/reference/nlp/prescription-scan-complex-posology.md): What the FHIR bundle gains when the detect_complex_posology option is enabled on the prescription scan — infusions, dated phases, dose ceilings, renewals.
- 🔒 [Prescription structuring](/docs/en/apis/reference/nlp/prescription.md): API for analyzing a complete medical prescription and extracting prescribed elements (drugs, medical devices, dosages).
- 🔒 [API Playground](/docs/en/apis/reference/playground.md): Interactive playground for a selection of NLP and clinical analysis endpoints.
- 🔒 [FHIR model of the prescription](/docs/en/apis/types/fhir-prescription-model.md): Description of the FHIR model of the prescription
- 🔒 [Structured dosage model](/docs/en/apis/types/posology-model-internal.md): Description of the structured dosage model
- 🔒 [Structured dosage model](/docs/en/apis/types/posology-model.md): Description of the structured dosage model
- 🔒 [Shared Input Types](/docs/en/apis/types/shared-input-types.md): Common GraphQL input types used across clinical analysis APIs
- 🔒 **MedicalDB** — section requires a valid access (pages not listed)
- 🔒 **Widgets** — section requires a valid access (pages not listed)