{"components":{"parameters":{"code":{"description":"The code to look up (e.g., `22298006` for SNOMED CT, `I21` for ICD-10, `diaDI21` for SKS).","in":"query","name":"code","required":true,"schema":{"type":"string"}},"displayLanguage":{"description":"BCP-47 language tag for the preferred display term (e.g., `da` for Danish, `en` for English).","in":"query","name":"displayLanguage","required":false,"schema":{"type":"string"}},"system":{"description":"Code system canonical URI. Examples: `http://snomed.info/sct`, `http://hl7.org/fhir/sid/icd-10`, `urn:oid:1.2.208.176.2.4.12`. Supports versioned URIs with pipe syntax (`http://snomed.info/sct|20240101`) and SNOMED CT path format (`http://snomed.info/sct/900000000000207008/version/20240101`).","in":"query","name":"system","required":true,"schema":{"type":"string"}}},"schemas":{"AIDisclosure":{"description":"EU AI Act (Regulation 2024/1689) Art. 50 disclosure block. Always present on this endpoint's 200 response — a deterministic (non-AI) result is disclosed as such rather than leaving the block out, so its absence always means a client is not talking to a marked endpoint.","properties":{"aiGenerated":{"description":"True when an AI path (LLM generation, LLM re-ranking, or SapBERT semantic retrieval) produced or contributed to the result. False for a purely deterministic/lexical result.","type":"boolean"},"article50":{"description":"True when Art. 50 transparency obligations attach to this output (equals aiGenerated).","type":"boolean"},"disclosure":{"description":"`ai-generated` — the model produced the finished artifact (generated text). `ai-suggested` — a candidate a human reviews and selects. `none` — no AI path was involved; Art. 50 does not attach.","enum":["ai-generated","ai-suggested","none"],"type":"string"},"model":{"description":"Identity of the model behind the output, resolved from the deployment's AI transparency registry. Omitted when aiGenerated is false, and omitted (rather than fabricated) when the deployment publishes no model card — the aiGenerated/disclosure/article50 marker is never dropped with it.","properties":{"id":{"description":"Model card id in the transparency registry.","type":"string"},"name":{"type":"string"},"version":{"type":"string"}},"type":"object"}},"required":["aiGenerated","disclosure","article50"],"type":"object"},"Coding":{"properties":{"code":{"type":"string"},"display":{"type":"string"},"system":{"format":"uri","type":"string"},"version":{"type":"string"}},"type":"object"},"Expansion":{"properties":{"contains":{"items":{"$ref":"#/components/schemas/ExpansionEntry"},"type":"array"},"identifier":{"type":"string"},"offset":{"type":"integer"},"timestamp":{"format":"date-time","type":"string"},"total":{"type":"integer"}},"type":"object"},"ExpansionEntry":{"properties":{"code":{"type":"string"},"designation":{"items":{"properties":{"language":{"type":"string"},"use":{"$ref":"#/components/schemas/Coding"},"value":{"type":"string"}},"type":"object"},"type":"array"},"display":{"type":"string"},"inactive":{"type":"boolean"},"system":{"format":"uri","type":"string"}},"type":"object"},"OperationOutcome":{"properties":{"issue":{"items":{"properties":{"code":{"type":"string"},"diagnostics":{"type":"string"},"severity":{"enum":["fatal","error","warning","information"],"type":"string"}},"required":["severity","code"],"type":"object"},"type":"array"},"resourceType":{"enum":["OperationOutcome"],"type":"string"}},"required":["resourceType","issue"],"type":"object"},"Parameter":{"description":"A single named parameter with one typed value.","properties":{"name":{"type":"string"},"part":{"items":{"$ref":"#/components/schemas/Parameter"},"type":"array"},"valueBoolean":{"type":"boolean"},"valueCode":{"type":"string"},"valueCoding":{"$ref":"#/components/schemas/Coding"},"valueInteger":{"type":"integer"},"valueString":{"type":"string"},"valueUri":{"format":"uri","type":"string"}},"required":["name"],"type":"object"},"Parameters":{"properties":{"parameter":{"items":{"$ref":"#/components/schemas/Parameter"},"type":"array"},"resourceType":{"enum":["Parameters"],"type":"string"}},"required":["resourceType"],"type":"object"},"ValueSet":{"properties":{"expansion":{"$ref":"#/components/schemas/Expansion"},"resourceType":{"enum":["ValueSet"],"type":"string"}},"required":["resourceType","expansion"],"type":"object"}}},"info":{"contact":{"name":"Bitsort","url":"https://bitsort.com"},"description":"FHIR R4 terminology API for SNOMED CT, ICD-10, ICD-11, SKS, LOINC, and 20+ code systems. Includes standard FHIR operations ($lookup, $validate-code, $subsumes, $translate, $expand), value-add operations (autocomplete, chain-translate, semantic search, clinical NER, PHI de-identification), SMART on FHIR authorization, bulk data export, subscriptions, and conversion services.\n\nThis spec is filtered to show only the endpoints available to your subscription plan. Upgrade to see additional operations.","license":{"name":"Proprietary"},"title":"Codon — FHIR Terminology Service API","version":"dev"},"openapi":"3.0.3","paths":{"/ai-transparency":{"get":{"description":"Returns a machine-readable transparency package documenting all AI components deployed in this Codon instance, including model cards, risk classifications, training data provenance, performance metrics, and transparency notices per EU AI Act Regulation 2024/1689 Article 50.","operationId":"aiTransparency","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"article":{"example":"Article 50","type":"string"},"components":{"items":{"type":"object"},"type":"array"},"dataSovereignty":{"type":"string"},"generatedAt":{"format":"date-time","type":"string"},"product":{"example":"Codon","type":"string"},"provider":{"example":"Therapon Systems","type":"string"},"regulation":{"example":"EU AI Act (Regulation 2024/1689)","type":"string"}},"type":"object"}}},"description":"Transparency package with all AI component model cards."}},"summary":"EU AI Act Article 50 transparency package","tags":["Compliance"]}},"/fhir/$validate":{"post":{"description":"Validates a FHIR resource against one or more StructureDefinition profiles (DK Core, IPS, MedCom). Returns an OperationOutcome with issues.","operationId":"validateProfile","parameters":[{"description":"Canonical URL of the StructureDefinition to validate against.","in":"query","name":"profile","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR resource JSON to validate.","required":true},"responses":{"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"},"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Validation result"},"summary":"Validate a FHIR resource against profiles","tags":["Validation"]}},"/fhir/CodeSystem":{"get":{"description":"Returns a FHIR Bundle of all registered CodeSystem resources with metadata (name, URL, version, publisher).","operationId":"listCodeSystems","responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Bundle of CodeSystem resources"}},"summary":"List all code systems","tags":["CodeSystem"]},"post":{"description":"Creates a tenant-private custom CodeSystem (content `complete`). The server mints a tenant-namespaced URL from the supplied `slug`. Clinical+ feature.","operationId":"createTenantCodeSystem","requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"FHIR CodeSystem JSON with `slug`, `name`, `status` (draft|active), `content`=complete, and \u003e=1 `concept` with a `code`.","required":true},"responses":{"201":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Created FHIR CodeSystem"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Create a tenant custom code system","tags":["CodeSystem"]}},"/fhir/CodeSystem/$autocomplete":{"get":{"description":"Fast prefix-based concept search optimized for clinical typeahead. Uses edge n-gram indexing for sub-10ms response times. Returns results ranked by relevance. Searches across preferred terms, synonyms, FSN, and codes.","operationId":"autocomplete","parameters":[{"$ref":"#/components/parameters/system"},{"description":"The partial text to autocomplete.","in":"query","name":"term","required":true,"schema":{"type":"string"}},{"description":"Maximum number of suggestions (default 10).","in":"query","name":"count","required":false,"schema":{"default":100,"type":"integer"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"ValueSet expansion with matching concepts"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Autocomplete / typeahead search","tags":["CodeSystem"]}},"/fhir/CodeSystem/$find-matches":{"get":{"description":"Finds coded concepts that match a set of property/attribute values. Unlike $expand with a text filter (free-text search), $find-matches does structured, property-based search. For SNOMED CT, properties map to defining relationships (e.g., Finding site, Associated morphology). Supports subsumption-aware matching (descendants of the target value also match) and partial matching with scoring.","operationId":"findMatchesGET","parameters":[{"$ref":"#/components/parameters/system"},{"description":"Property criteria as code|value or code$value pairs (repeating). Code is a SNOMED CT attribute type SCTID or display name (e.g., `363698007|80891009` or `Finding site|80891009`).","explode":true,"in":"query","name":"property","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"If true, return only concepts matching ALL properties. If false (default), also return partial matches ranked by score.","in":"query","name":"exact","required":false,"schema":{"type":"string"}},{"description":"Maximum results to return (default 10).","in":"query","name":"count","required":false,"schema":{"default":100,"type":"integer"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Parameters with match entries. Each match contains a valueCoding (system, code, display) and an unmatched part listing properties not satisfied by this concept."},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Find concepts by property values","tags":["CodeSystem"]},"post":{"description":"Finds coded concepts that match a set of property/attribute values. Unlike $expand with a text filter (free-text search), $find-matches does structured, property-based search. For SNOMED CT, properties map to defining relationships (e.g., Finding site, Associated morphology). Supports subsumption-aware matching (descendants of the target value also match) and partial matching with scoring.","operationId":"findMatchesPOST","requestBody":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Parameters resource with `system` (valueUri), repeating `property` parameters each containing `code` (valueCode) and `value` (valueCode) sub-parts, and optional `exact` (valueBoolean).","required":true},"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Parameters with match entries. Each match contains a valueCoding (system, code, display) and an unmatched part listing properties not satisfied by this concept."},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Find concepts by property values","tags":["CodeSystem"]}},"/fhir/CodeSystem/$lookup":{"get":{"description":"Returns the display name, properties, and designations for a code within a code system. Returns typed properties (valueBoolean, valueCode, valueString), designations with `use` coding (FSN/Synonym/Definition), and `parent`/`child` hierarchy properties.","operationId":"lookupGET","parameters":[{"$ref":"#/components/parameters/system"},{"$ref":"#/components/parameters/code"},{"description":"BCP-47 language tag for the preferred display term.","in":"query","name":"displayLanguage","required":false,"schema":{"type":"string"}},{"description":"Filter: only return these property codes (repeating). If omitted, all properties are returned.","explode":true,"in":"query","name":"property","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Parameters with name, system, version, display, properties, designations, and inactive flag"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Look up a code","tags":["CodeSystem"]},"post":{"description":"Returns the display name, properties, and designations for a code within a code system. Returns typed properties (valueBoolean, valueCode, valueString), designations with `use` coding (FSN/Synonym/Definition), and `parent`/`child` hierarchy properties.","operationId":"lookupPOST","requestBody":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Parameters resource with `system` (valueUri), `code` (valueCode), optional `coding` (valueCoding), `displayLanguage` (valueCode), `property` (valueCode, repeating).","required":true},"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Parameters with name, system, version, display, properties, designations, and inactive flag"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Look up a code","tags":["CodeSystem"]}},"/fhir/CodeSystem/$resolve-replacement":{"get":{"description":"Follows historical associations (REPLACED_BY, SAME_AS) from an inactive concept to find the terminal active replacement. Returns the full chain with association types.","operationId":"resolveReplacement","parameters":[{"$ref":"#/components/parameters/system"},{"$ref":"#/components/parameters/code"}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Replacement chain with terminal concept"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Resolve replacement chain for inactive concept","tags":["CodeSystem"]}},"/fhir/CodeSystem/$validate-code":{"get":{"description":"Checks whether a code exists and is valid in a code system. Returns `result` (boolean), `display`, `inactive` flag, and `message` for warnings (e.g., inactive code, display mismatch).","operationId":"validateCodeGET","parameters":[{"$ref":"#/components/parameters/system"},{"$ref":"#/components/parameters/code"},{"description":"If provided, the server validates that this display matches a known designation for the code.","in":"query","name":"display","required":false,"schema":{"type":"string"}},{"description":"BCP-47 language tag.","in":"query","name":"displayLanguage","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Parameters with result (boolean), display, inactive, and message"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Validate a code","tags":["CodeSystem"]},"post":{"description":"Checks whether a code exists and is valid in a code system. Returns `result` (boolean), `display`, `inactive` flag, and `message` for warnings (e.g., inactive code, display mismatch).","operationId":"validateCodePOST","requestBody":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Parameters with `system`, `code`, optional `display`, `displayLanguage`.","required":true},"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Parameters with result (boolean), display, inactive, and message"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Validate a code","tags":["CodeSystem"]}},"/fhir/CodeSystem/{id}":{"delete":{"description":"Deletes a tenant-private custom CodeSystem and its concepts. Clinical+ feature.","operationId":"deleteTenantCodeSystem","parameters":[{"description":"Custom CodeSystem ID.","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"OperationOutcome"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Delete a tenant custom code system","tags":["CodeSystem"]},"get":{"description":"Returns a FHIR CodeSystem resource with metadata. Content is `not-present` -- use $lookup for individual concept details.","operationId":"getCodeSystem","parameters":[{"description":"CodeSystem ID (e.g., `snomed-ct`, `icd-10`, `sks`).","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR CodeSystem resource"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Get a CodeSystem resource","tags":["CodeSystem"]},"put":{"description":"Updates a tenant-private custom CodeSystem in place (single mutable version). The URL is immutable. Clinical+ feature.","operationId":"updateTenantCodeSystem","parameters":[{"description":"Custom CodeSystem ID.","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"FHIR CodeSystem JSON (same shape as create; url is ignored).","required":true},"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Updated FHIR CodeSystem"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Update a tenant custom code system","tags":["CodeSystem"]}},"/fhir/ConceptMap":{"get":{"description":"Returns a FHIR Bundle of all registered ConceptMap resources with metadata (source/target systems, status, provenance).","operationId":"listConceptMaps","responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Bundle of ConceptMap resources"}},"summary":"List all ConceptMaps","tags":["ConceptMap"]},"post":{"description":"Imports a FHIR ConceptMap JSON body. Parses group/element/target structure and flattens to stored mappings with provenance tracking.","operationId":"importConceptMap","requestBody":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR ConceptMap resource JSON.","required":true},"responses":{"201":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Import successful"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Import a ConceptMap","tags":["ConceptMap"]}},"/fhir/ConceptMap/{id}":{"delete":{"description":"Fully removes a tenant-private ConceptMap (metadata + every mapping). Append-only history rows are closed, not deleted, so the tamper-evident chain survives. Global, official, or cross-tenant maps cannot be deleted (clone first to create a tenant copy).","operationId":"deleteConceptMap","parameters":[{"description":"ConceptMap ID.","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"ConceptMap deleted"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Delete a tenant ConceptMap","tags":["ConceptMap"]},"get":{"description":"Returns a FHIR ConceptMap resource with nested group/element/target structure. Supports pagination via `_count` and `_offset`.","operationId":"getConceptMap","parameters":[{"description":"ConceptMap ID (e.g., `snomed-ct-to-icd-10`).","in":"query","name":"id","required":true,"schema":{"type":"string"}},{"description":"Max mappings to return (default 1000).","in":"query","name":"_count","required":false,"schema":{"default":100,"type":"integer"}},{"description":"Skip this many mappings (default 0).","in":"query","name":"_offset","required":false,"schema":{"default":100,"type":"integer"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR ConceptMap resource"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Get a ConceptMap with mappings","tags":["ConceptMap"]}},"/fhir/ConceptMap/{id}/$gaps":{"get":{"description":"Returns source concepts from the ConceptMap's source system that have no active mapping.","operationId":"conceptMapGaps","parameters":[{"description":"ConceptMap ID.","in":"query","name":"id","required":true,"schema":{"type":"string"}},{"description":"Max results (default 1000).","in":"query","name":"_count","required":false,"schema":{"default":100,"type":"integer"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Parameters with gap entries"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"List unmapped source concepts","tags":["ConceptMap"]}},"/fhir/ConceptMap/{id}/$stats":{"get":{"description":"Returns coverage statistics: total source codes, mapped count, coverage percentage, breakdown by equivalence type.","operationId":"conceptMapStats","parameters":[{"description":"ConceptMap ID.","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Coverage statistics"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Mapping coverage analytics","tags":["ConceptMap"]}},"/fhir/ConceptMap/{id}/$versions":{"get":{"description":"Returns a FHIR Bundle of the published immutable version snapshots of a tenant-private ConceptMap (header + version + mapping count, newest first). Clinical+ feature.","operationId":"listTenantConceptMapVersions","parameters":[{"description":"ConceptMap ID.","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Bundle of frozen ConceptMap version summaries"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"List a tenant ConceptMap's frozen versions","tags":["ConceptMap"]}},"/fhir/NamingSystem":{"get":{"description":"Returns a FHIR Bundle of all NamingSystem resources. NamingSystems map OIDs, URIs, and human-readable names for code systems.","operationId":"listNamingSystems","responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Bundle of NamingSystem resources"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"List NamingSystems","tags":["NamingSystem"]}},"/fhir/NamingSystem/{id}":{"get":{"description":"Returns a single NamingSystem resource by ID.","operationId":"getNamingSystem","parameters":[{"description":"NamingSystem ID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"NamingSystem resource"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Read NamingSystem","tags":["NamingSystem"]}},"/fhir/OperationDefinition":{"get":{"description":"Returns a FHIR Bundle of all operations this server supports, with parameter declarations.","operationId":"listOperationDefinitions","responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Bundle of OperationDefinition resources"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"List OperationDefinitions","tags":["OperationDefinition"]}},"/fhir/OperationDefinition/{id}":{"get":{"description":"Returns a single OperationDefinition resource by operation code.","operationId":"getOperationDefinition","parameters":[{"description":"Operation code (e.g., lookup, expand, translate)","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"OperationDefinition resource"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Read OperationDefinition","tags":["OperationDefinition"]}},"/fhir/SearchParameter":{"get":{"description":"Returns a FHIR Bundle of all SearchParameter resources declared by this server.","operationId":"listSearchParameters","responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Bundle of SearchParameter resources"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"List SearchParameters","tags":["SearchParameter"]}},"/fhir/SearchParameter/{id}":{"get":{"description":"Returns a single SearchParameter resource by ID.","operationId":"getSearchParameter","parameters":[{"description":"SearchParameter ID.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"SearchParameter resource"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Read SearchParameter","tags":["SearchParameter"]}},"/fhir/TerminologyCapabilities":{"get":{"description":"Returns the server's TerminologyCapabilities declaring supported code systems, filters, and expansion parameters.","operationId":"terminologyCapabilities","responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"TerminologyCapabilities resource"}},"summary":"FHIR TerminologyCapabilities","tags":["Conformance"]}},"/fhir/ValueSet":{"get":{"operationId":"listValueSets","responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Bundle of ValueSet resources"}},"summary":"List all value sets","tags":["ValueSet"]},"post":{"description":"Creates an extensional (explicit codes) or intensional (ECL-based) value set definition.","operationId":"createValueSet","requestBody":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"ValueSet JSON with id, system, type (extensional/intensional), codes or expression.","required":true},"responses":{"201":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"ValueSet created"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Create a value set","tags":["ValueSet"]}},"/fhir/ValueSet/$validate-code":{"get":{"description":"Validates whether a code is a member of a ValueSet defined by system + ECL expression. First validates the code exists, then checks membership via ECL expansion.","operationId":"validateCodeVSGET","parameters":[{"$ref":"#/components/parameters/system"},{"$ref":"#/components/parameters/code"},{"description":"ValueSet system URI (alias for system).","in":"query","name":"url","required":false,"schema":{"type":"string"}},{"description":"ECL expression defining the ValueSet membership (e.g., `\u003c\u003c 73211009`).","in":"query","name":"ecl","required":false,"schema":{"type":"string"}},{"description":"Display to validate against known designations.","in":"query","name":"display","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Parameters with result (boolean), display, message"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Validate code against a ValueSet","tags":["ValueSet"]},"post":{"operationId":"validateCodeVSPOST","requestBody":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Parameters with system, code, url, ecl, display.","required":true},"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Parameters with result"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Validate code against a ValueSet (POST)","tags":["ValueSet"]}},"/fhir/ValueSet/{id}":{"delete":{"operationId":"deleteValueSet","parameters":[{"description":"ValueSet ID.","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"}},"summary":"Delete a value set","tags":["ValueSet"]},"get":{"operationId":"getValueSet","parameters":[{"description":"ValueSet ID.","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"ValueSet resource"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Get a value set","tags":["ValueSet"]},"put":{"operationId":"updateValueSet","parameters":[{"description":"ValueSet ID.","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"ValueSet JSON with fields to update.","required":true},"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"ValueSet updated"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Update a value set","tags":["ValueSet"]}},"/fhir/ValueSet/{id}/$clone":{"post":{"description":"Creates an editable copy of a ValueSet in the caller's organisation. Official (shared) ValueSets are read-only; use $clone to derive a custom version you can edit freely.","operationId":"cloneValueSet","parameters":[{"description":"Source ValueSet ID to clone.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"id":{"description":"Custom ID for the clone. Auto-generated if omitted.","type":"string"},"name":{"description":"Custom name for the clone. Inherited from source if omitted.","type":"string"}},"type":"object"}}},"description":"Optional: override id and name for the clone."},"responses":{"201":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Cloned ValueSet"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Clone a ValueSet","tags":["ValueSet"]}},"/fhir/ValueSet/{id}/$export-fsh":{"get":{"description":"Renders a value set's composition as FHIR Shorthand text (application/fsh). Composition-only — a stored expansion or an unrepresentable compose construct fails loud (422) rather than emitting a partial.","operationId":"exportValueSetFSH","parameters":[{"description":"ValueSet ID.","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fsh":{"schema":{"type":"string"}}},"description":"FSH text"}},"summary":"Export a ValueSet as FHIR Shorthand (FSH)","tags":["ValueSet"]}},"/fhir/ValueSet/{id}/$versions":{"get":{"description":"Returns a FHIR Bundle of the published immutable version snapshots of a tenant-private ValueSet (header + version + member count, newest first). Clinical+ feature.","operationId":"listTenantValueSetVersions","parameters":[{"description":"ValueSet ID.","in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR Bundle of frozen ValueSet version summaries"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"List a tenant ValueSet's frozen versions","tags":["ValueSet"]}},"/fhir/feed":{"get":{"description":"Server-Sent Events stream of real-time changes to terminology resources. Useful for cache invalidation or downstream sync.","operationId":"feed","responses":{"200":{"content":{"text/event-stream":{"schema":{"type":"string"}}},"description":"SSE event stream."}},"summary":"Change feed","tags":["Conformance"]}},"/fhir/metadata":{"get":{"description":"Returns the server's CapabilityStatement describing supported operations, FHIR version, and formats. Pass `?mode=terminology` (FHIR R4 §3.2.1.5) to receive a TerminologyCapabilities resource instead, declaring code systems, ECL features, and supported $expand parameters.","operationId":"metadata","parameters":[{"description":"When set to `terminology` (or `terminologycapabilities`), returns a TerminologyCapabilities resource instead of CapabilityStatement.","in":"query","name":"mode","required":false,"schema":{"enum":["terminology","terminologycapabilities"],"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"CapabilityStatement resource (default) or TerminologyCapabilities (when ?mode=terminology)"}},"summary":"FHIR CapabilityStatement","tags":["Conformance"]}},"/fhir/{type}/$validate":{"post":{"description":"Validates a FHIR resource of a specific type against StructureDefinition profiles.","operationId":"validateProfileTyped","parameters":[{"description":"FHIR resource type (e.g., Patient, Observation).","in":"query","name":"type","required":true,"schema":{"type":"string"}},{"description":"Canonical URL of the StructureDefinition.","in":"query","name":"profile","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"FHIR resource JSON to validate.","required":true},"responses":{"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"},"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Validation result"},"summary":"Validate a typed FHIR resource against profiles","tags":["Validation"]}},"/health":{"get":{"operationId":"healthCheck","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"status":{"example":"ok","type":"string"}},"type":"object"}}},"description":"Service is healthy"}},"summary":"Health check","tags":["Health"]}},"/medcom/profiles":{"get":{"description":"Returns all loaded MedCom Implementation Guide profiles with version metadata.","operationId":"medcomProfiles","responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"MedCom profile inventory"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"List MedCom FHIR profiles","tags":["MedCom"]}},"/medcom/profiles/{ig}":{"get":{"operationId":"medcomProfilesByIG","parameters":[{"description":"MedCom IG identifier (e.g., hospital-notification, discharge-summary).","in":"query","name":"ig","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Profiles for the specified IG"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Get profiles for a MedCom IG","tags":["MedCom"]}},"/medcom/profiles/{ig}/{version}":{"get":{"operationId":"medcomProfilesByIGVersion","parameters":[{"description":"MedCom IG identifier.","in":"query","name":"ig","required":true,"schema":{"type":"string"}},{"description":"IG version (e.g., 3.0.0).","in":"query","name":"version","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"Profiles for the specified IG version"},"400":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Bad request — missing or invalid parameters"},"404":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Not found — code does not exist in the specified system"},"500":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/OperationOutcome"}}},"description":"Internal server error"}},"summary":"Get a specific MedCom IG version","tags":["MedCom"]}},"/openapi.json":{"get":{"operationId":"openAPISpec","responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"OpenAPI 3.0.3 specification (public endpoints)"}},"summary":"OpenAPI specification (public)","tags":["Conformance"]}},"/ready":{"get":{"description":"Returns 200 when the service is ready to accept traffic (database connected, indexes loaded). Used by load balancers and Kubernetes.","operationId":"readinessProbe","responses":{"200":{"description":"Service is ready."},"503":{"description":"Service is not yet ready."}},"summary":"Readiness probe","tags":["Health"]}},"/status":{"get":{"description":"Returns structured service status for status page integration. Includes component health, version, and uptime.","operationId":"serviceStatus","responses":{"200":{"content":{"application/fhir+json":{"schema":{"$ref":"#/components/schemas/Parameters"}}},"description":"All systems operational"},"503":{"description":"Major outage — one or more critical components are down."}},"summary":"Service status","tags":["Health"]}},"/swagger":{"get":{"operationId":"swaggerUI","responses":{"200":{"description":"Interactive API documentation (public endpoints)"}},"summary":"Swagger UI (public)","tags":["Conformance"]}},"/version":{"get":{"description":"Returns the running version, git commit, and build date.","operationId":"version","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"commit":{"type":"string"},"date":{"type":"string"},"version":{"type":"string"}},"type":"object"}}},"description":"Version information."}},"summary":"API version","tags":["Health"]}}},"servers":[{"description":"Configured deployment (NEXUS_BASE_URL)","url":"https://codon.theraponsystems.dk"}],"tags":[{"description":"FHIR CodeSystem operations","name":"CodeSystem"},{"description":"FHIR ConceptMap operations","name":"ConceptMap"},{"description":"FHIR ValueSet operations","name":"ValueSet"},{"description":"FHIR batch processing","name":"Batch"},{"description":"FHIR conformance and async status","name":"Conformance"},{"description":"Service health, readiness, version","name":"Health"},{"description":"Profile-based FHIR resource validation","name":"Validation"},{"description":"EU AI Act transparency, regulatory","name":"Compliance"}]}