Clinical Analysis Pipeline
Understanding the three backend services powering Posos clinical analysis APIs
Posos clinical analysis APIs are organized across three backend services, each handling a distinct category of clinical decision support. All three are GraphQL APIs that share the same authentication mechanism and input types.
Architecture Overview
AORT — Prescription Analysis & Treatment Recommendation
post/aort-api-v3/v1/graphql
AORT (Analyse d’Ordonnance et Recommandation de Traitement) is a CE-marked Class IIb medical device under EU Regulation 2017/745. It provides the core clinical safety checks:
| Query | Purpose |
|---|---|
getInteractions | Drug-drug interaction detection |
getContraindications | Contraindication detection based on patient profile |
getAdverseEffects | Adverse effect listing for drugs |
getAllergyIntolerance | Allergy detection in a drug list |
getAlternatives | Treatment recommendations for a given indication |
getSam | HAS decision support alerts (SAM) |
getCalc | Clinical calculators |
getCompatibility | Physico-chemical compatibility between drugs |
getBiologicalCriteria | Biological monitoring criteria |
getPostStopCriteria | Monitoring criteria after stopping a drug |
getMedicalDeviceLabel | Medical device label retrieval |
ARP — Dosage Analysis & Recommendation
post/arp-api-v2/v1/graphql
ARP (Analyse et Recommandation de Posologie) is also a CE-marked Class IIb medical device. It focuses on dosage-related safety:
| Query | Purpose |
|---|---|
getDosageAlert | Detect dosage issues (overdose, underdose, maximum duration) |
getTherapeuticDuplication | Active substance redundancy detection |
getDoseAdjustmentEligibility | Eligibility for quick dose adjustment |
getDoseCombination | Combination of presentations reaching a target dose |
getActiveSubstanceQuantity | Active substance quantity by period |
getMedicalDeviceLabel | Medical device label retrieval |
AAE — Additional Analysis & Enrichment
post/aae-api/v1/graphql
AAE provides supplementary analysis capabilities:
| Query | Purpose |
|---|---|
getDosageUnits | Retrieve dosage units for a prescription |
getRestrictedPrescriptions | Retrieve prescription conditions and restrictions |
getPrescriptionCost | Calculate total prescription cost |
Regional availability
Analysis services accept region: fr-FR, region: fr-BE or region: nl-BE (Belgium, Dutch text). Some features remain France-only. Accepted drug identifiers also depend on the market: posos, CIS, UCD, or CIP in France; vmp, amp, or CNK in Belgium.
Typical Integration Flow
- Authenticate — Obtain a token via Posos authentication
- Resolve drug identifiers — Use the autocomplete API or NERL to obtain an identifier for the selected region
- Call analysis APIs — Send drug codes to the appropriate service(s) based on the checks you need
- Process results — Handle the typed response for each query: alerts, criteria, calculations, costs, units, or labels
Which service should I call? Use AORT for clinical safety and recommendations, ARP for dosage analysis and adjustment, and AAE for administrative and economic data. An integration can call several services based on its needs.
See Also
- API Catalog — Complete endpoint reference
- Drug Identification — How drugs are coded and identified
- Prescription Analysis Guide — Step-by-step integration guide
Last updated on