Advanced Synthetic Health Data Generation API v1.7.2
Generate configurable synthetic health datasets with demographic and clinical parameters.
/generatecount (required, integer): Number of patients to generateformat (optional, default: fhir): Output formatseed (optional, integer): Seed for reproducible generationage_min, age_max (optional): Age range constraintskennitala (optional): Patient identifier (e.g., kennitala) (overrides other params)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/generate?count=5&age_min=40&age_max=50&condition=I10/generate?count=3&condition=E11.9,I10,J44.9&forceEdgeCases=trueAccess synthetic data through standard R4 endpoints with advanced healthcare filtering capabilities.
/fhir/R4/metadata
/fhir/R4/Patient?_count=3
/fhir/R4/Patient?numberOfMedicines=3/fhir/R4/Patient?numberOfMedicinesFrom=2&numberOfMedicinesTo=4/fhir/R4/Patient?numberOfConditionTypesFrom=2/fhir/R4/Patient?numberOfConditionTypesTo=1/fhir/R4/Patient?conditionChronicity=chronic/fhir/R4/Patient?ConditionTypes=K21.9&ConditionTypes=R51/fhir/R4/Patient?ageFrom=70&ageTo=85/fhir/R4/Patient?ConditionTypes=K21.9&ConditionTypes=R51&numberOfMedicinesFrom=5&ageFrom=70&forceEdgeCases=5/fhir/R4/Patient?locale=is&_count=3/generate?kennitala=0101302989/fhir/R4/Condition?code=M54.5&_count=3
Retrieve all conditions for a specific patient with enhanced clinical metadata including recorder, category, and lifecycle information.
/fhir/R4/Patient/{kennitala}/Conditionseed (optional, integer): Seed for deterministic resultsconditionTypes (optional): Filter by chronic or acute conditions/fhir/R4/Patient/0101302989/Condition/fhir/R4/Patient/0101302989/Condition?seed=12345/fhir/R4/Patient/0101302989/Condition?conditionTypes=chronicRetrieve FHIR-compliant medication resources for specific patients with comprehensive pharmaceutical data and clinical context.
/fhir/R4/Patient/{kennitala}/MedicationStatement
seed (optional, integer): Seed for deterministic results/fhir/R4/Patient/0101302989/MedicationStatement/fhir/R4/Patient/0101302989/MedicationStatement?seed=123Query synthetic healthcare data conversationally through AI assistants like Claude Desktop, ChatGPT, or compatible LLM clients. No FHIR expertise required. Learn more about MCP →
| 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 | |
"Generate 50 female patients with type 2 diabetes aged 40-60"
"Find patients with chronic conditions taking 2-4 medications"
"Show me the medications for patient 0101302989 with Icelandic therapeutic reasons"
"Compare how medications are represented in R4 versus R5 for this patient"
claude_desktop_config.json:
{
"mcpServers": {
"k01-synthetic-health": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.k01.is/mcp",
"--header",
"Authorization: Bearer K01_API_TOKEN"
]
}
}
}Need detailed documentation? Contact K01 support for comprehensive MCP integration guides, troubleshooting, and advanced usage examples.
Advanced medication generation with clinical awareness and realistic healthcare patterns.
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)Professional-grade medical terminology with intelligent locale detection.
Advanced patient classification for healthcare workflow optimization.
numberOfConditionTypesFrom: Find patients requiring complex carenumberOfConditionTypesTo: Find patients with simple health profilesThe following ICD-10 codes are currently available for synthetic data generation:
/fhir/R4/* and /fhir/R5/*ConditionTypes - find patients with exact condition combinationsforceEdgeCases=5 generates N patients guaranteed to match ALL filters (conditions, age, medications)/fhir/Patient/{id}/Condition/fhir/Patient/{id}/MedicationStatementreasonCode field)medication-summary-categorynumberOfConditionTypesTonumberOfConditionTypesFromforceEdgeCasesseed parameter