API Catalog
Overview of documented Posos APIs, endpoints, and regional availability
This page lists the Posos APIs documented for customer integrations. Access depends on the contract, environment, and region. Some partner extensions and internal services are documented separately.
Base URLs:
- Preprod:
https://api.preprod.posos.co- Production:
https://api.production.posos.co
Regions and endpoints
Region conventions vary by service. MedicalDB uses a separate endpoint for Belgium.
| Service | Endpoint | France | Belgium (French) | Belgium (Dutch) |
|---|---|---|---|---|
| AORT | /aort-api-v3/v1/graphql | ?region=fr-FR | ?region=fr-BE | ?region=nl-BE |
| ARP | /arp-api-v2/v1/graphql | ?region=fr-FR | ?region=fr-BE | ?region=nl-BE |
| AAE | /aae-api/v1/graphql | ?region=fr-FR | ?region=fr-BE | ?region=nl-BE |
| Autocomplete | /autocomplete-api/autocomplete | ?locale=fr_FR | ?locale=fr_BE | ?locale=nl_BE |
| NERL | /nerl/v2/nerl | ?lang=fr | ?lang=fr | — |
| MedicalDB (BIM) | /mdb/fr-fr-v2/v1/graphql | /mdb/fr-fr-v2/v1/graphql | /mdb/fr-be-v2/v1/graphql | /mdb/nl-be-v2/v1/graphql |
Analysis APIs
Clinical decision support APIs that analyze prescriptions for safety and optimization.
The three GraphQL services use a region parameter. The matrix details feature availability in France and Belgium. They also accept region=nl-BE, which has the same features as Belgium with Dutch text (see regions and markets).
AORT — Prescription Analysis & Treatment Recommendation
post/aort-api-v3/v1/graphql
| API | Query | Description |
|---|---|---|
| Interactions | getInteractions | Check for drug-drug interactions |
| Contraindications | getContraindications | Detect contraindications based on patient profile |
| Side effects | getAdverseEffects | List adverse effects for drugs |
| Allergy | getAllergyIntolerance | Detect allergic reactions in a drug list |
| Treatment Recommendation | getAlternatives | Recommend alternatives for a given indication |
| Indications | getIndications | List the clinical indications of a drug list |
| Drug-Indexed Decision Support (HAS) | getSam | Retrieve HAS SAM alerts for drugs |
| Calculators | getCalc | Perform clinical calculations |
| Physico-chemical compatibility | getCompatibility | Check physico-chemical compatibility between drugs |
| Biological criteria | getBiologicalCriteria | Retrieve biological monitoring criteria |
| Post-stop criteria | getPostStopCriteria | Retrieve monitoring criteria after stopping a drug |
| Anticholinergic load | getAnticholinergicLoads | Compute the anticholinergic load of a drug list, per scale |
| Medical device label | getMedicalDeviceLabel | Retrieve a medical device label from its code |
ARP — Dosage Analysis
post/arp-api-v2/v1/graphql
| API | Query | Description |
|---|---|---|
| Dosage alerts | getDosageAlert | Detect dosage issues (overdose, underdose, duration) |
| Therapeutic duplication | getTherapeuticDuplication | Detect active substance redundancy |
| Dose adjustment eligibility | getDoseAdjustmentEligibility | Eligibility of a prescribed drug for a quick dose adjustment |
| Dose combination | getDoseCombination | Combination of presentations reaching a target dose per intake exactly |
| Active substance quantity | getActiveSubstanceQuantity | Active substance quantity per day, per week and per month |
| Medical device label | getMedicalDeviceLabel | Retrieve a medical device label from its code |
AAE — Administrative and Economic Analysis
post/aae-api/v1/graphql
| API | Query | Description |
|---|---|---|
| Dosage units | getDosageUnits | Retrieve dosage units for a prescription |
| Prescription cost | getPrescriptionCost | Calculate total cost of a prescription |
| Prescription conditions | getRestrictedPrescriptions | Retrieve restricted prescription conditions |
NLP APIs
Natural language processing for drug search and dosage parsing.
| API | Endpoint | Method | Description |
|---|---|---|---|
| Autocompletion | /autocomplete-api/autocomplete | GET | Search for drugs, ingredients, indications, and medical entities |
| NERL | /nerl/v2/nerl | GET | Extract and link medical entities from text |
| Dosage structuring | /nerl/v2/nerl | GET | Parse free-text dosage instructions into structured data |
| Dosage reconstruction | /nerl/v2/poso_reconstructor | POST | Reconstruct dosages from structured data into free-text instructions |
| Prescription structuring | /nerl/v3/prescription | POST | Analyze a full prescription and extract prescribed elements Preview |
Prescription Scan
| API | Endpoint | Method | Description |
|---|---|---|---|
| Prescription scan | /scanordo/v2/scan-ordo | POST | Extract structured data from prescription images/PDFs (returns FHIR Bundle) |
| Complex dosage detection | /scanordo/v2/scan-ordo | POST | Detect dosages that require validation with detect_complex_posology=true |
Clinical documents
Preview Analysis of hospital reports and integration of their content into the patient record.
| API | Endpoint | Method | Description |
|---|---|---|---|
| Document analysis | /nerl/v3/documents/analysis | POST | Coded entities, sections, document type and patient record items from a report, as text or file |
| Record reconciliation | /v3/records/reconcile | POST | Comparison of a document’s items with the patient record (FHIR R4 Bundle) |
| Record reconciliation | /v3/records/apply | POST | FHIR transaction Bundle of the changes approved by the clinician |
Partner Connect
APIs for contextual integration of Posos functionalities into partner software.
| API | Endpoint | Method | Description |
|---|---|---|---|
| Contextual call | /api/partners/proxy/prepare | POST | Open a Posos guide with pre-loaded patient context |
| Scan & Go | /api/partners/patient/scan-token | POST | Obtain a URL for prescription import and validation |
| QR Code | /api/partners/patient/qrcode | GET | Generate a QR Code linking to a patient file |
MedicalDB (BIM)
post/mdb/fr-fr-v2/v1/graphql
A comprehensive drug database providing clinical drugs, branded drugs, ingredients, indications, interactions, pricing, and more.
Standards-Based APIs
| API | Endpoint | Protocol | Description |
|---|---|---|---|
| CDS Hooks | https://cds-hooks.{env}.posos.co | CDS Hooks | HL7 CDS Hooks standard for drug interaction verification |
| FHIR Warehouse | https://fhir.production.trusted.posos.co/fhir/r4/:slug | FHIR R4 | Read-only access to scanned prescriptions |
MCP Server
| API | Endpoint | Protocol | Description |
|---|---|---|---|
| Posos MCP Server | https://mcp.production.posos.co/api/v1/mcp | MCP over HTTP | OAuth access to Posos tools for AI assistants |
Widgets
Embeddable UI components for clinical decision support.
| API | Endpoint | Method | Description |
|---|---|---|---|
| User Authentication | /api/v1/admin/token | POST | Generate access tokens for widget users |
Last updated on