Source of truth for implementation is the canonical schema host: https://schemas.meta-aiml.org/v3.0.0/. If any page text conflicts with canonical schema files, follow canonical files. Documentation home.

Clinic

v3.0.0

PhysicalEntity

Healthcare

v3 schema for outpatient clinics and ambulatory care providers delivering medical services directly to patients at controlled facilities with appointment and care coordination workflows.

Top-level required

Required modules

Capability groups

Entity properties

Canonical Files

Contract URL: https://schemas.meta-aiml.org/v3.0.0/entity/clinic.json

Example URL: https://schemas.meta-aiml.org/v3.0.0/examples/clinic_example_schema_v3.json

Inheritance Chain

https://schemas.meta-aiml.org/v3.0.0/ontology/physical_entity.json

https://schemas.meta-aiml.org/v3.0.0/archetypes/direct_service.json

Interaction archetype

DirectService

Required Top-level Fields

These fields are enforced by JSON Schema required[] at root level.

@type

ontologicalMode

interactionArchetype

domain

name

description

deliveryFormat

modules

capabilities

structuralMetadata

Non-universal required fields

interactionArchetype

Entity-specific Properties

Keys under properties.properties dedicated to this entity contract.

acceptedAgeGroups

clinicType

contactPoints

identifiers

socialProfiles

specialties

supportsTeleconsultFollowUp

supportsWalkIns

Modules Contract

Required modules

location

Optional modules

appointments

records

Capabilities Contract

Required capability groups

interaction

booking

Optional capability groups

content

financial

location

Governance Validation Rules

Normative rule list from governanceMetadata.sdkValidationRules.

RULE-CLIN-001: @type MUST equal "Clinic"

RULE-CLIN-002: ontologicalMode MUST equal "PhysicalEntity"

RULE-CLIN-003: interactionArchetype MUST contain "DirectService"

RULE-CLIN-004: deliveryFormat MUST contain "PhysicalLocation"

RULE-CLIN-005: modules.location MUST be present

RULE-CLIN-006: capabilities.interaction MUST be present

Canonical Contract JSON

https://schemas.meta-aiml.org/v3.0.0/entity/clinic.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://schemas.meta-aiml.org/v3.0.0/entity/clinic.json",
  "$id": "https://schemas.meta-aiml.org/v3.0.0/entity/clinic.json",
  "@type": "Clinic",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Clinic Entity Schema",
  "description": "v3 schema for outpatient clinics and ambulatory care providers delivering medical services directly to patients at controlled facilities with appointment and care coordination workflows.",
  "examples": [
    {
      "description": "Primary care clinic with scheduled appointments and digital intake forms",
      "reference": "clinic_example_primary_care"
    },
    {
      "description": "Specialty clinic with referral triage and on-site diagnostics support",
      "reference": "clinic_example_specialty_care"
    }
  ],
  "type": "object",
  "additionalProperties": false,
  "allOf": [
    {
      "$ref": "../ontology/physical_entity.json"
    },
    {
      "$ref": "../archetypes/direct_service.json"
    }
  ],
  "properties": {
    "@type": {
      "const": "Clinic"
    },
    "ontologicalMode": {
      "const": "PhysicalEntity"
    },
    "interactionArchetype": {
      "type": "array",
      "contains": {
        "const": "DirectService"
      },
      "items": {
        "type": "string",
        "enum": [
          "DirectService"
        ]
      }
    },
    "domain": {
      "const": "Healthcare"
    },
    "businessModel": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "InsuranceReimbursement",
          "Transactional",
          "Subscription"
        ]
      }
    },
    "deliveryFormat": {
      "type": "array",
      "contains": {
        "const": "PhysicalLocation"
      },
      "items": {
        "type": "string",
        "enum": [
          "PhysicalLocation",
          "WebApp",
          "MobileApp"
        ]
      }
    },
    "name": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
    },
    "description": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
    },
    "shortDescription": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedTextOrString"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "foundingDate": {
      "type": "string",
      "format": "date"
    },
    "properties": {
      "type": "object",
      "properties": {
        "clinicType": {
          "type": "string",
          "enum": [
            "primary_care",
            "urgent_care",
            "specialty",
            "multi_specialty"
          ]
        },
        "supportsWalkIns": {
          "type": "boolean"
        },
        "supportsTeleconsultFollowUp": {
          "type": "boolean"
        },
        "specialties": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "acceptedAgeGroups": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "pediatric",
              "adult",
              "geriatric",
              "all_ages"
            ]
          }
        },
        "contactPoints": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/ContactPoint"
          }
        },
        "socialProfiles": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/SocialProfile"
          }
        },
        "identifiers": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/Identifier"
          }
        }
      }
    },
    "capabilities": {
      "type": "object",
      "required": [
        "interaction",
        "booking"
      ],
      "properties": {
        "interaction": {
          "$ref": "../components/capability_groups.json#/$defs/InteractionCapabilities"
        },
        "booking": {
          "$ref": "../components/capability_groups.json#/$defs/BookingCapabilities"
        },
        "financial": {
          "$ref": "../components/capability_groups.json#/$defs/FinancialCapabilities"
        },
        "content": {
          "$ref": "../components/capability_groups.json#/$defs/ContentCapabilities"
        },
        "location": {
          "$ref": "../components/capability_groups.json#/$defs/LocationCapabilities"
        }
      }
    },
    "modules": {
      "type": "object",
      "required": [
        "location"
      ],
      "properties": {
        "location": {
          "type": "object",
          "properties": {
            "address": {
              "$ref": "../components/address_format.json#/$defs/PostalAddress"
            },
            "geoCoordinates": {
              "$ref": "../components/address_format.json#/$defs/GeoCoordinates"
            },
            "parkingInfo": {
              "type": "string"
            }
          }
        },
        "appointments": {
          "type": "object",
          "properties": {
            "onlineSchedulingEnabled": {
              "type": "boolean"
            },
            "waitlistEnabled": {
              "type": "boolean"
            },
            "reminderChannels": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "sms",
                  "email",
                  "push"
                ]
              }
            }
          }
        },
        "records": {
          "type": "object",
          "properties": {
            "ehrIntegrationEnabled": {
              "type": "boolean"
            },
            "patientPortalEnabled": {
              "type": "boolean"
            },
            "consentWorkflowEnabled": {
              "type": "boolean"
            }
          }
        }
      }
    },
    "structuralMetadata": {
      "type": "object",
      "properties": {
        "topology": {
          "const": "binary"
        },
        "roles": {
          "const": [
            "user",
            "platform"
          ]
        },
        "valueSource": {
          "const": "platform_provided"
        },
        "transactionFlow": {
          "const": "direct"
        },
        "networkEffects": {
          "const": "none"
        },
        "careMode": {
          "type": "string",
          "enum": [
            "appointment_based",
            "walk_in",
            "hybrid"
          ]
        }
      }
    },
    "targetAudience": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "siteCapabilities": {
      "type": "object",
      "properties": {
        "supportedDevices": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "desktop",
              "mobile",
              "tablet"
            ]
          }
        },
        "languages": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "accessibilityFeatures": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "@type",
    "ontologicalMode",
    "interactionArchetype",
    "domain",
    "name",
    "description",
    "deliveryFormat",
    "modules",
    "capabilities",
    "structuralMetadata"
  ],
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "entity",
    "status": "draft",
    "lastValidated": "2026-02-20T12:00:00Z",
    "validator": "META-AIML QA"
  },
  "semanticAnnotations": {
    "classificationRationale": "Clinic is modeled as PhysicalEntity + DirectService because treatment is delivered directly by the provider within physical care facilities.",
    "disambiguationNotes": "This schema is for care delivery organizations, not provider discovery marketplaces."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "draft",
    "sdkValidationRules": [
      "RULE-CLIN-001: @type MUST equal \"Clinic\"",
      "RULE-CLIN-002: ontologicalMode MUST equal \"PhysicalEntity\"",
      "RULE-CLIN-003: interactionArchetype MUST contain \"DirectService\"",
      "RULE-CLIN-004: deliveryFormat MUST contain \"PhysicalLocation\"",
      "RULE-CLIN-005: modules.location MUST be present",
      "RULE-CLIN-006: capabilities.interaction MUST be present"
    ]
  }
}

Filled Example Instance

https://schemas.meta-aiml.org/v3.0.0/examples/clinic_example_schema_v3.json

{
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://data.meta-aiml.org/v3.0.0/examples/clinic/harborpoint-outpatient-center",
  "$id": "https://data.meta-aiml.org/v3.0.0/examples/clinic/harborpoint-outpatient-center",
  "@type": "Clinic",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Example Filled Clinic Entity Example (HarborPoint Outpatient Center)",
  "ontologicalMode": "PhysicalEntity",
  "interactionArchetype": [
    "DirectService"
  ],
  "domain": "Healthcare",
  "businessModel": [
    "InsuranceReimbursement",
    "Transactional",
    "Subscription"
  ],
  "deliveryFormat": [
    "PhysicalLocation",
    "WebApp",
    "MobileApp"
  ],
  "name": {
    "en": "HarborPoint Outpatient Center",
    "es": "Centro Ambulatorio HarborPoint",
    "fr": "Centre Ambulatoire HarborPoint"
  },
  "description": {
    "en": "HarborPoint Outpatient Center is a fictional multi-specialty clinic delivering scheduled and walk-in ambulatory care with coordinated diagnostics, digital intake, and post-visit follow-up workflows.",
    "es": "HarborPoint Outpatient Center es una clinica ambulatoria ficticia de varias especialidades con atencion programada, atencion sin cita y seguimiento digital posterior a la consulta.",
    "fr": "HarborPoint Outpatient Center est une clinique ambulatoire fictive multi-specialites proposant rendez-vous, visites sans rendez-vous et suivi numerique apres consultation."
  },
  "shortDescription": {
    "en": "Multi-specialty outpatient clinic with scheduling, triage, and digital care coordination.",
    "es": "Clinica ambulatoria multi-especialidad con agenda, triaje y coordinacion de cuidado digital.",
    "fr": "Clinique ambulatoire multi-specialites avec planification, triage et coordination numerique des soins."
  },
  "url": "https://harborpoint-clinic.example",
  "foundingDate": "2017-09-12",
  "createdDate": "2026-02-20T20:05:00Z",
  "lastModified": "2026-02-20T20:05:00Z",
  "examples": [
    {
      "scenario": "High same-day appointment demand on influenza week",
      "note": "AI should prioritize direct-service intake, waitlist balancing, and reminder workflows without exposing patient-level sensitive data."
    },
    {
      "scenario": "Referral intake for cardiology and endocrinology",
      "note": "AI should route users through specialty scheduling and records transfer workflows while preserving compliance and consent controls."
    }
  ],
  "properties": {
    "clinicType": "multi_specialty",
    "supportsWalkIns": true,
    "supportsTeleconsultFollowUp": true,
    "specialties": [
      "family_medicine",
      "cardiology",
      "endocrinology",
      "dermatology"
    ],
    "acceptedAgeGroups": [
      "adult",
      "geriatric"
    ],
    "contactPoints": [
      {
        "contactType": "customer_service",
        "telephone": "+1-206-555-0154",
        "email": "care@harborpoint-clinic.example",
        "url": "https://harborpoint-clinic.example/contact",
        "areaServed": "Seattle Metro",
        "availableLanguages": [
          "en",
          "es",
          "fr"
        ]
      },
      {
        "contactType": "technical",
        "telephone": "+1-206-555-0121",
        "email": "portal-support@harborpoint-clinic.example",
        "url": "https://harborpoint-clinic.example/patient-portal",
        "areaServed": "Seattle Metro",
        "availableLanguages": [
          "en"
        ]
      }
    ],
    "socialProfiles": [
      {
        "platform": "linkedin",
        "url": "https://www.linkedin.com/company/harborpoint-clinic",
        "username": "harborpoint-clinic"
      },
      {
        "platform": "facebook",
        "url": "https://facebook.com/harborpointclinic",
        "username": "harborpointclinic"
      }
    ],
    "identifiers": [
      {
        "type": "url",
        "value": "https://harborpoint-clinic.example"
      },
      {
        "type": "custom",
        "value": "CLIN-HPOC-001"
      }
    ]
  },
  "capabilities": {
    "interaction": {
      "features": [
        "messaging",
        "notifications"
      ],
      "interactionMethods": [
        "online_form",
        "phone_call",
        "chat"
      ],
      "availableActions": [
        "book_visit",
        "reschedule_visit",
        "upload_referral",
        "contact_clinic"
      ],
      "hasMessaging": true,
      "hasComments": false,
      "hasRating": false,
      "hasReviews": false,
      "hasSocialGraph": false,
      "hasFeed": false,
      "hasNotifications": true,
      "hasMatching": false,
      "realTimeCommunication": true,
      "moderationEnabled": true,
      "privacyControls": [
        "private"
      ]
    },
    "booking": {
      "features": [
        "reservation",
        "availabilityCheck",
        "scheduling",
        "waitlist",
        "cancellation",
        "reminder"
      ],
      "acceptsReservations": true,
      "requiresDeposit": false,
      "cancellationPolicy": "24_hours",
      "minimumAdvanceBooking": "PT30M",
      "maximumAdvanceBooking": "P90D",
      "realTimeFeatures": [
        "real_time_availability",
        "instant_confirmation"
      ],
      "bookingChannels": [
        "website",
        "mobile_app",
        "phone"
      ]
    },
    "financial": {
      "features": [
        "payments",
        "invoicing",
        "refunds",
        "billing",
        "subscriptionManagement"
      ],
      "paymentMethods": [
        "credit_card",
        "debit_card",
        "digital_wallet",
        "insurance_billing"
      ],
      "acceptsCreditCards": true,
      "currencies": [
        "USD"
      ],
      "priceRange": "insurance_and_self_pay",
      "commissionModel": "flat_fee",
      "commissionRate": 0,
      "supportsSubscriptions": true,
      "supportsInvoicing": true,
      "refundPolicy": "partial_refund"
    },
    "content": {
      "features": [
        "publishing",
        "search",
        "categories",
        "archives"
      ],
      "contentTypes": [
        "care_guideline",
        "faq",
        "insurance_policy",
        "clinic_notice"
      ],
      "contentFormats": [
        "text",
        "html",
        "pdf"
      ],
      "contentAccess": [
        "public",
        "member"
      ],
      "editorialControl": true,
      "userGeneratedContent": false,
      "mediaHosting": false,
      "searchPossible": true,
      "hasCategorization": true,
      "hasTagging": false,
      "archiveAccess": true,
      "rssFeeds": false
    },
    "location": {
      "features": [
        "physicalAddress",
        "geoCoordinates",
        "directions",
        "mapIntegration"
      ],
      "hasPhysicalAddress": true,
      "hasGeoCoordinates": true,
      "hasMultipleLocations": false,
      "hasParking": true,
      "parkingType": "onsite",
      "isWheelchairAccessible": true,
      "publicTransitAccess": true,
      "deliveryZones": [],
      "serviceRadius": 25
    }
  },
  "modules": {
    "location": {
      "address": {
        "streetAddress": "845 Harbor Avenue",
        "addressLocality": "Seattle",
        "addressRegion": "WA",
        "postalCode": "98104",
        "addressCountry": "US"
      },
      "geoCoordinates": {
        "latitude": 47.6021,
        "longitude": -122.3348,
        "accuracy": 10
      },
      "parkingInfo": "Onsite parking garage with 72 spaces and ADA access near the main entrance."
    },
    "appointments": {
      "onlineSchedulingEnabled": true,
      "waitlistEnabled": true,
      "reminderChannels": [
        "sms",
        "email",
        "push"
      ]
    },
    "records": {
      "ehrIntegrationEnabled": true,
      "patientPortalEnabled": true,
      "consentWorkflowEnabled": true
    },
    "triage": {
      "symptomIntakeEnabled": true,
      "urgencyScoringEnabled": true,
      "nurseEscalationWorkflow": true
    },
    "compliance": {
      "privacyNoticeVersion": "2026.1",
      "auditTrailEnabled": true,
      "retentionPolicyDefined": true
    }
  },
  "structuralMetadata": {
    "topology": "binary",
    "roles": [
      "user",
      "platform"
    ],
    "valueSource": "platform_provided",
    "transactionFlow": "direct",
    "networkEffects": "none",
    "careMode": "hybrid"
  },
  "targetAudience": [
    "local_residents",
    "working_professionals",
    "chronic_care_patients"
  ],
  "siteCapabilities": {
    "supportedDevices": [
      "desktop",
      "mobile",
      "tablet"
    ],
    "languages": [
      "en",
      "es",
      "fr"
    ],
    "accessibilityFeatures": [
      "keyboard_navigation",
      "screen_reader_labels",
      "text_scaling",
      "high_contrast_mode"
    ]
  },
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "example_instance",
    "status": "reference",
    "lastValidated": "2026-02-20T20:05:00Z",
    "validator": "META-AIML SDK v3"
  },
  "semanticAnnotations": {
    "classificationRationale": "Clinic is modeled as PhysicalEntity plus DirectService because care delivery is first-party and performed by the provider at controlled facilities.",
    "disambiguationNotes": "This model is not a doctor marketplace. It represents direct care operations, scheduling, records, and patient communication under one provider contract.",
    "intendedUse": "Canonical filled reference for clinic websites publishing static AI-readable architecture metadata."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "reference",
    "sdkValidationRules": [
      "RULE-CLGF-001: @type MUST equal \"Clinic\"",
      "RULE-CLGF-002: ontologicalMode MUST equal \"PhysicalEntity\"",
      "RULE-CLGF-003: interactionArchetype MUST contain exactly one value: \"DirectService\"",
      "RULE-CLGF-004: deliveryFormat MUST include \"PhysicalLocation\"",
      "RULE-CLGF-005: modules.location MUST include valid address and geoCoordinates",
      "RULE-CLGF-006: capabilities MUST include interaction and booking groups",
      "RULE-CLGF-007: structuralMetadata constants MUST align with DirectService archetype",
      "RULE-CLGF-008: examples MUST include at least two operational scenarios"
    ]
  }
}

All entities Hotel