K01
Service Status
K01

K01 API

Status & docs.

v1.9.1

Service Status

01 / Status
Core API Service
Checking...
Data Generation API
Dependent
FHIR Format API
Dependent
Last checked: Never

Technical Specifications

02 / Specs

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 & R5 Compliance

  • Full FHIR R4 (v4.0.1) and R5 (v5.0.0) support
  • Multi-version routing with backward compatibility
  • Enhanced patient bundles with clinical summaries
  • UCUM units compliance for observations
  • 10+ advanced search parameters

International Localization

  • WHO API integration (EN/FR/ES)
  • Professional Icelandic medical terminology
  • Auto-locale detection from patient identifiers
  • 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

API Endpoints

03 / API

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): Patient identifier (e.g., kennitala) (overrides other params)
  • Clinical Filters:
    • condition (optional): Required ICD-10 codes (comma-separated)
    • forceEdgeCases (optional, boolean or integer): Enable systematic edge case testing. true generates 1 patient, integer (e.g., 5) generates N patients with ALL specified conditions and maximum medications
  • Examples:

FHIR Standard Endpoints Auth Required

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

Patient Conditions GET Auth Required

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

Patient Medications GET Auth Required

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

  • Endpoint: /fhir/R4/Patient/{kennitala}/MedicationStatement
  • Resource Type: MedicationStatement (R4)
  • 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:

Model Context Protocol (MCP) Beta

04 / MCP

Query synthetic healthcare data conversationally through AI assistants like Claude Desktop, ChatGPT, or compatible LLM clients. No FHIR expertise required. Learn more about MCP →

Quick Comparison

Aspect REST API MCP Interface
Interface HTTP requests with JSON Natural language queries
Learning Curve Must understand FHIR standards Conversational, intuitive
Best For Production integrations, automated workflows Research, data exploration, prototyping
Data Source Same FHIR-compliant synthetic data

Key Capabilities

Available Operations

Example Queries

Cohort Generation:
"Generate 50 female patients with type 2 diabetes aged 40-60"
Patient Search:
"Find patients with chronic conditions taking 2-4 medications"
Clinical Data:
"Show me the medications for patient 0101302989 with Icelandic therapeutic reasons"
FHIR Comparison:
"Compare how medications are represented in R4 versus R5 for this patient"

Quick Setup for Claude Desktop

  1. Get your K01 API token - Contact K01 support for access
  2. Configure Claude Desktop - Add MCP server configuration to claude_desktop_config.json: 
    {
  "mcpServers": {
    "k01-synthetic-health": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.k01.is/mcp",
        "--header",
        "Authorization: Bearer K01_API_TOKEN"
      ]
    }
  }
}
  3. Restart Claude Desktop - K01 tools will appear in the tool list
  4. Start querying - Use natural language to generate and explore healthcare data

Need detailed documentation? Contact K01 support for comprehensive MCP integration guides, troubleshooting, and advanced usage examples.

Major Features

05 / Features

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

Healthcare Localization

Professional-grade 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

Supported ICD-10 Codes

06 / ICD-10

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

Recent Updates

07 / Updates

April 2026

  • API version 1.9.1
  • Tiered API access (Free / Developer / Pro / Enterprise)
  • Billing integration
  • Usage dashboard and API key management

March 2026

  • Automated data quality scoring with statistical and clinical validation
  • Benchmark reporting with per-cohort scorecards
  • CSV exports in relational and flat formats for research workflows
  • Enriched clinical metadata in exported datasets

February 2026

  • Improved clinical coherence: conditions better drive realistic medications and lab values
  • Age-dependent mortality modeling using Gompertz curves
  • Condition-specific observation values (e.g., elevated glucose in diabetic patients)
  • 3-layer clinical validation test suite for quality assurance
  • Immunodeficiency (D84.8) cohort support

January 2026

  • API version 1.8.0 with enhanced medication realism
  • Enhanced API security and access controls
  • Disease-specific age and gender distributions for more realistic patient profiles
  • CSV export module for tabular data delivery

December 2025

  • Improved medication and vital sign realism
  • Expanded international identifier support
  • Region-specific cohort generation with locale parameter
  • Managing organization assignments for patient records

November 2025

  • Optimized organization-based patient filtering
  • Enhanced API performance monitoring

October 2025

  • Model Context Protocol (MCP) server for natural language interface
  • 6 conversational tools for cohort design and patient queries
  • Integration support for Claude Desktop and compatible LLM clients
  • FHIR R5 (v5.0.0) support - latest FHIR standard now available
  • Multi-version endpoints: /fhir/R4/* and /fhir/R5/*
  • Flexible version selection via URL path or Accept header
  • MedicationUsage resource (R5 updated terminology)
  • 100% backward compatible - all existing R4 endpoints continue working
  • Specific ICD-10 code filtering with ConditionTypes - find patients with exact condition combinations
  • Integer edge cases - forceEdgeCases=5 generates N patients guaranteed to match ALL filters (conditions, age, medications)

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 medical terminology with localization support
  • 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