API Catalog
This page provides a comprehensive overview of all available Posos APIs, grouped by backend service.
Base URLs:
- Preprod:
https://api.preprod.posos.co- Production:
https://api.production.posos.co
Analysis APIs
Clinical decision support APIs that analyze prescriptions for safety and optimization.
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 |
| 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 |
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 |
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 |
| 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) |
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/bim/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 |
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 |