When Aidbox is configured with FHIRSchema mode, it is possible to define Extension in FHIRSchema format .

See also Extensions using StructureDefinition.

Example

To create the extension, use POST /fhir/FHIRSchema endpoint.

POST /fhir/FHIRSchema

url: http://my-extension/insurance-plan-reference
id: insurance-plan-reference
base: Extension
name: insurance-plan-reference
kind: complex-type
type: Extension
version: 0.0.1
resourceType: FHIRSchema
elements:
  url:
    fixed: http://my-extension/insurance-plan-reference
  value:
    choices:
      - valueReference
  valueReference:
    type: Reference
    refers:
      - InsurancePlan
    choiceOf: value
derivation: constraint

When the extension is created, you can inspect it in "FHIR Packages" Aidbox UI page.

Usage of the extension:

PUT /fhir/Coverage/my-coverage

extension:
- url: http://my-extension/insurance-plan-reference
  valueReference: 
    reference: InsurancePlan/ip1
payor: 
- reference: Patient/pt1
beneficiary:
  reference: Patient/pt1
status: active

Last updated 2025-08-07T12:18:32Z