K01 API Status & Documentation

Core API Service

Checking...

Data Generation API

Dependent

FHIR Format API

Dependent

Performance & Scale

Deterministic pool architecture for consistent results
High-performance generation with large patient pools
Sub-second response times for complex queries
Scalable to enterprise healthcare workflows

FHIR R4 Compliance

Full FHIR R4 standard implementation
Enhanced patient bundles with clinical summaries
UCUM units compliance for observations
10+ advanced search parameters

Multi-Language Support

Professional Icelandic medical terminology
WHO API integration (EN/FR/ES)
Auto-locale detection from kennitala
Future-ready for ICD-11 migration

Integration Testing

Systematic edge case generation for testing
Healthcare workflow optimization support
Complex health issues detection capabilities
Backward compatible API design

Bulk Data Generation GET Auth Required

Generate configurable synthetic health datasets with demographic and clinical parameters.

Endpoint: /generate
Core Parameters:
- count (required, integer): Number of patients to generate
- format (optional, default: fhir): Output format
- seed (optional, integer): Seed for reproducible generation
Demographic Filters:
- age_min, age_max (optional): Age range constraints
- kennitala (optional): Specific Icelandic ID (overrides other params)
Clinical Filters:
- condition (optional): Required ICD-10 codes (comma-separated)
- forceEdgeCases (optional, boolean): Enable systematic edge case testing - first patient gets ALL specified conditions and maximum medications, others follow normal distribution
Examples:
- Standard generation: /generate?count=5&age_min=40&age_max=50&condition=I10
- Edge case testing: /generate?count=3&condition=E11.9,I10,J44.9&forceEdgeCases=true

FHIR Standard Endpoints Auth Required

Access synthetic data through standard FHIR R4 endpoints with advanced healthcare filtering capabilities.

Capability Statement: /fhir/metadata
Basic Patient Search: /fhir/Patient?_count=3
Healthcare-Specific Filtering:
- Medication count: /fhir/Patient?numberOfMedicines=3
- Medication range: /fhir/Patient?numberOfMedicinesFrom=2&numberOfMedicinesTo=4
- Complex health issues: /fhir/Patient?numberOfConditionTypesFrom=2
- Simple health profiles: /fhir/Patient?numberOfConditionTypesTo=1
- Condition chronicity: /fhir/Patient?conditionTypes=chronic
- Combined filtering: /fhir/Patient?numberOfConditions=3&conditionTypes=chronic&numberOfMedicinesFrom=2
Locale-Aware Responses:
- Icelandic: /fhir/Patient?locale=is&_count=3
- Auto-detection: /generate?kennitala=0101302989
Condition Search: /fhir/Condition?code=M54.5&_count=3

Patient Conditions GET Auth Required

Retrieve all conditions for a specific patient with enhanced clinical metadata including recorder, category, and lifecycle information.

Endpoint: /fhir/Patient/{kennitala}/Condition
Features:
- Auto-locale detection from kennitala format
- Enhanced condition metadata with Phase 3.1 fields
- Practitioner recorder information
- Chronic/acute classification with extensions
- Lifecycle management flags (isLongTerm, isShortTerm, IsLifeThreatening)
Parameters:
- seed (optional, integer): Seed for deterministic results
- conditionTypes (optional): Filter by chronic or acute conditions
Examples:
- Icelandic patient: /fhir/Patient/0101302989/Condition
- With seed: /fhir/Patient/0101302989/Condition?seed=12345
- Chronic only: /fhir/Patient/0101302989/Condition?conditionTypes=chronic

Patient Medication Statements GET Auth Required

Retrieve FHIR-compliant MedicationStatement resources for specific patients with comprehensive pharmaceutical data and clinical context.

Endpoint: /fhir/Patient/{kennitala}/MedicationStatement
Features:
- Enhanced FHIR compliance with adherence, route, and author fields
- Route-aware dosage instructions (oral vs inhalation) with SNOMED codes
- Pharmaceutical company references and batch information
- ATC medication codes with localized display names
- Clinical context including prescriber and adherence status
Parameters:
- seed (optional, integer): Seed for deterministic results
Examples:
- Icelandic patient: /fhir/Patient/0101302989/MedicationStatement
- With seed: /fhir/Patient/0101302989/MedicationStatement?seed=123

Comprehensive Medication System

Advanced medication generation with clinical awareness and realistic healthcare patterns.

Four Medication Categories:
- permanent: Long-term chronic condition management (ACE inhibitors, diabetes medications)
- as_needed: PRN medications for symptom relief (pain relievers, bronchodilators)
- course: Time-limited treatment courses (antibiotics, steroid courses)
- institutional: Facility-administered medications (typically inpatient)
Clinical Realism:
- Age-appropriate medication selection
- Condition-aware prescribing patterns
- Realistic dosing and frequency
- ATC classification system integration
FHIR Integration:
- MedicationStatement resources with proper coding
- Enhanced patient bundles with medication summaries
- Medication count aggregation by category

Icelandic Healthcare Specialization

Professional-grade Icelandic medical terminology with intelligent locale detection.

Auto-Locale Detection:
- Automatic recognition of Icelandic kennitala format (10-digit pattern)
- Seamless switching between Icelandic and international terminology
- No configuration required for customer integration
Professional Medical Terminology:
- Comprehensive Icelandic translation dictionary
- Priority conditions: Sykursýki tegund II, Háþrýstingur, Offita
- Clinical accuracy maintained across both languages
WHO API Integration:
- Multi-language support framework (EN/FR/ES)
- Future-ready for ICD-11 migration
- Hybrid fallback system ensures 100% coverage

Complex Health Issues Detection

Advanced patient classification for healthcare workflow optimization.

Intelligent Condition Classification:
- Automatic chronic vs acute classification based on ICD-10 codes
- Complex health detection (patients with multiple condition types)
- Clinical severity assessment integration
Healthcare Workflow Support:
- Multi-specialty care coordination identification
- Care management priority stratification
- Resource allocation planning support
Advanced Filtering:
- numberOfConditionTypesFrom: Find patients requiring complex care
- numberOfConditionTypesTo: Find patients with simple health profiles
- Deterministic pool architecture for consistent results
- Database-like search behavior with healthcare-specific parameters

The following ICD-10 codes are currently available for synthetic data generation:

M54.5

J06.9

E11.9

I10

F41.9

K21.9

R07.9

L03.90

N39.0

R51

R50.9

R42

E78.5

F33.1

J45.909

L40.0

G43.909

N18.9

Z00.00

M25.561

E74.39

Q87.1

D84.8

A81.09

G31.89

M31.1

R53.82

P07.39

Z13.5

D03.59

September 2025

New Patient Conditions endpoint /fhir/Patient/{id}/Condition
Enhanced Condition fields: recorder, category, recordedDate
Intelligent lifecycle extensions (isLongTerm, isShortTerm, IsLifeThreatening)
Locale-aware practitioner names with auto-detection
Chronic/acute classification with FHIR extensions
FHIR-compliant MedicationStatement endpoint /fhir/Patient/{id}/MedicationStatement
Enhanced medication data: adherence, route (oral/inhalation), pharmaceutical companies
Route-aware dosage instructions with SNOMED codes
Deterministic seed support for all patient-specific endpoints
Enhanced MedicationStatement reasons with localized therapeutic indications (reasonCode field)
Patient-specific medication categorization based on clinical context (age, conditions)
Category correlation extension linking individual medications to summary counts via medication-summary-category
Improved seed determinism for patient-specific reproducible testing scenarios

August 2025

Simple health profiles detection with numberOfConditionTypesTo
Complex health issues detection with numberOfConditionTypesFrom
Systematic edge case testing with forceEdgeCases
Professional Icelandic medical terminology integration
Enhanced FHIR endpoints with 11+ advanced search parameters

July 2025

Enhanced patient bundles with medication/condition summaries
Advanced healthcare filtering (medication counts, condition types)
Deterministic pool architecture for consistent results
WHO API integration for multi-language support

May 2025

Added deterministic data generation with seed parameter
Improved API response times by 40%
Enhanced FHIR R4 compliance validation

April 2025

Launched comprehensive API status monitoring
Released bulk data generation endpoint with filtering
Implemented FHIR R4 standard endpoints
Added support for 30+ ICD-10 condition codes

Service Status

Technical Specifications