Clinical Analysis Pipeline

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

Endpoint: 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

ARP — Dosage Analysis & Recommendation

Endpoint: 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

AAE — Additional Analysis & Enrichment

Endpoint: 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

Typical Integration Flow

Authenticate — Obtain an identity token via IAP authentication
Resolve drug identifiers — Use the autocomplete API to convert drug names into clinical drug codes (terminology: posos, code prefix: MV)
Call analysis APIs — Send drug codes to the appropriate service(s) based on the checks you need
Process results — Each API returns structured alerts with severity levels, source references, and clinical recommendations

Which service should I call? If you need to check for interactions, contraindications, allergies, or side effects, use AORT. If you need dosage validation (overdose/underdose), use ARP. If you need prescription cost or prescription conditions, use AAE. Most integrations call multiple services for comprehensive analysis.