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.

Event

v3.0.0

EventEntity

Events

v3 schema for time-bounded events delivered directly to participants, including registration, scheduling, venue coordination, and attendee engagement workflows.

Top-level required

Required modules

Capability groups

Entity properties

Canonical Files

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

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

Inheritance Chain

https://schemas.meta-aiml.org/v3.0.0/ontology/event_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

eventDetails

capabilities

structuralMetadata

modules

Non-universal required fields

interactionArchetype

eventDetails

Entity-specific Properties

Keys under properties.properties dedicated to this entity contract.

audienceScale

contactPoints

eventCategory

identifiers

requiresRegistration

socialProfiles

supportsTicketTransfer

supportsWaitlist

Modules Contract

Required modules

No required modules for this entity.

Optional modules

agenda

registration

venue

Capabilities Contract

Required capability groups

interaction

Optional capability groups

booking

community

content

financial

Governance Validation Rules

Normative rule list from governanceMetadata.sdkValidationRules.

RULE-EVNT-001: @type MUST equal "Event"

RULE-EVNT-002: ontologicalMode MUST equal "EventEntity"

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

RULE-EVNT-004: eventDetails.startDate, eventDetails.endDate, eventDetails.eventType MUST be present

RULE-EVNT-005: capabilities.interaction MUST be present

RULE-EVNT-006: structuralMetadata.temporalBounded MUST equal "yes"

Canonical Contract JSON

https://schemas.meta-aiml.org/v3.0.0/entity/event.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/event.json",
  "$id": "https://schemas.meta-aiml.org/v3.0.0/entity/event.json",
  "@type": "Event",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Event Entity Schema",
  "description": "v3 schema for time-bounded events delivered directly to participants, including registration, scheduling, venue coordination, and attendee engagement workflows.",
  "examples": [
    {
      "description": "Professional conference with ticketing, session agenda, and check-in",
      "reference": "event_example_conference"
    },
    {
      "description": "Hybrid workshop series with recurring sessions and digital materials",
      "reference": "event_example_hybrid_workshop"
    }
  ],
  "type": "object",
  "additionalProperties": false,
  "allOf": [
    {
      "$ref": "../ontology/event_entity.json"
    },
    {
      "$ref": "../archetypes/direct_service.json"
    }
  ],
  "properties": {
    "@type": {
      "const": "Event"
    },
    "ontologicalMode": {
      "const": "EventEntity"
    },
    "interactionArchetype": {
      "type": "array",
      "contains": {
        "const": "DirectService"
      },
      "items": {
        "type": "string",
        "enum": [
          "DirectService"
        ]
      }
    },
    "domain": {
      "const": "Events"
    },
    "businessModel": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Ticketed",
          "Sponsorship",
          "Subscription",
          "Freemium"
        ]
      }
    },
    "deliveryFormat": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "InPersonAttendance",
          "VirtualStreaming",
          "HybridBoth"
        ]
      }
    },
    "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"
    },
    "eventDetails": {
      "type": "object",
      "required": [
        "startDate",
        "endDate",
        "eventType"
      ],
      "properties": {
        "startDate": {
          "type": "string",
          "format": "date-time"
        },
        "endDate": {
          "type": "string",
          "format": "date-time"
        },
        "eventType": {
          "type": "string",
          "enum": [
            "physical",
            "virtual",
            "hybrid"
          ]
        },
        "timezone": {
          "type": "string"
        },
        "recurrencePattern": {
          "type": "string",
          "enum": [
            "one_time",
            "recurring"
          ]
        }
      }
    },
    "properties": {
      "type": "object",
      "properties": {
        "eventCategory": {
          "type": "string",
          "enum": [
            "conference",
            "workshop",
            "webinar",
            "concert",
            "meetup",
            "sports"
          ]
        },
        "audienceScale": {
          "type": "string",
          "enum": [
            "small",
            "medium",
            "large",
            "very_large"
          ]
        },
        "requiresRegistration": {
          "type": "boolean"
        },
        "supportsWaitlist": {
          "type": "boolean"
        },
        "supportsTicketTransfer": {
          "type": "boolean"
        },
        "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"
      ],
      "properties": {
        "interaction": {
          "$ref": "../components/capability_groups.json#/$defs/InteractionCapabilities"
        },
        "booking": {
          "$ref": "../components/capability_groups.json#/$defs/BookingCapabilities"
        },
        "content": {
          "$ref": "../components/capability_groups.json#/$defs/ContentCapabilities"
        },
        "financial": {
          "$ref": "../components/capability_groups.json#/$defs/FinancialCapabilities"
        },
        "community": {
          "$ref": "../components/capability_groups.json#/$defs/CommunityCapabilities"
        }
      }
    },
    "modules": {
      "type": "object",
      "properties": {
        "registration": {
          "type": "object",
          "properties": {
            "registrationOpenDate": {
              "type": "string",
              "format": "date-time"
            },
            "registrationCloseDate": {
              "type": "string",
              "format": "date-time"
            },
            "approvalWorkflowEnabled": {
              "type": "boolean"
            }
          }
        },
        "agenda": {
          "type": "object",
          "properties": {
            "multiTrackEnabled": {
              "type": "boolean"
            },
            "sessionCapacityControlEnabled": {
              "type": "boolean"
            },
            "speakerManagementEnabled": {
              "type": "boolean"
            }
          }
        },
        "venue": {
          "type": "object",
          "properties": {
            "physicalAddress": {
              "$ref": "../components/address_format.json#/$defs/PostalAddress"
            },
            "geoCoordinates": {
              "$ref": "../components/address_format.json#/$defs/GeoCoordinates"
            },
            "virtualVenueUrl": {
              "type": "string",
              "format": "uri"
            }
          }
        }
      }
    },
    "structuralMetadata": {
      "type": "object",
      "properties": {
        "topology": {
          "const": "binary"
        },
        "roles": {
          "const": [
            "user",
            "platform"
          ]
        },
        "valueSource": {
          "const": "platform_provided"
        },
        "transactionFlow": {
          "const": "direct"
        },
        "networkEffects": {
          "const": "none"
        },
        "temporalBounded": {
          "const": "yes"
        }
      }
    },
    "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",
    "eventDetails",
    "capabilities",
    "structuralMetadata",
    "modules"
  ],
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "entity",
    "status": "draft",
    "lastValidated": "2026-02-20T12:00:00Z",
    "validator": "META-AIML QA"
  },
  "semanticAnnotations": {
    "classificationRationale": "Event is modeled as EventEntity + DirectService because the platform directly delivers bounded temporal experiences to participants.",
    "disambiguationNotes": "Different from event listing aggregators that mediate discovery but do not deliver first-party event operations."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "draft",
    "sdkValidationRules": [
      "RULE-EVNT-001: @type MUST equal \"Event\"",
      "RULE-EVNT-002: ontologicalMode MUST equal \"EventEntity\"",
      "RULE-EVNT-003: interactionArchetype MUST contain \"DirectService\"",
      "RULE-EVNT-004: eventDetails.startDate, eventDetails.endDate, eventDetails.eventType MUST be present",
      "RULE-EVNT-005: capabilities.interaction MUST be present",
      "RULE-EVNT-006: structuralMetadata.temporalBounded MUST equal \"yes\""
    ]
  }
}

Filled Example Instance

https://schemas.meta-aiml.org/v3.0.0/examples/event_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/event/summit-pulse-global-conference",
  "$id": "https://data.meta-aiml.org/v3.0.0/examples/event/summit-pulse-global-conference",
  "@type": "Event",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Example Filled Event Entity Example (Summit Pulse Global Conference)",
  "ontologicalMode": "EventEntity",
  "interactionArchetype": [
    "DirectService"
  ],
  "domain": "Events",
  "businessModel": [
    "Ticketed",
    "Sponsorship",
    "Subscription"
  ],
  "deliveryFormat": [
    "InPersonAttendance",
    "VirtualStreaming",
    "HybridBoth"
  ],
  "name": {
    "en": "Summit Pulse Global Conference 2026",
    "es": "Summit Pulse Global Conference 2026",
    "fr": "Summit Pulse Global Conference 2026"
  },
  "description": {
    "en": "Summit Pulse Global Conference 2026 is a fictional hybrid event combining in-person sessions, virtual tracks, and structured attendee engagement workflows for enterprise and technology professionals.",
    "es": "Summit Pulse Global Conference 2026 es un evento hibrido ficticio con sesiones presenciales, tracks virtuales y flujos de registro y participacion para profesionales.",
    "fr": "Summit Pulse Global Conference 2026 est un evenement hybride fictif avec sessions sur site, parcours virtuels et engagement structure des participants."
  },
  "shortDescription": {
    "en": "Hybrid conference schema with registration, agenda, and venue coordination.",
    "es": "Esquema de conferencia hibrida con registro, agenda y coordinacion de sede.",
    "fr": "Schema de conference hybride avec inscription, agenda et coordination du lieu."
  },
  "url": "https://summitpulse-event.example",
  "foundingDate": "2019-05-15",
  "createdDate": "2026-02-20T18:48:00Z",
  "lastModified": "2026-02-20T18:48:00Z",
  "eventDetails": {
    "startDate": "2026-09-22T15:00:00Z",
    "endDate": "2026-09-25T01:00:00Z",
    "eventType": "hybrid",
    "timezone": "America/Los_Angeles",
    "recurrencePattern": "recurring"
  },
  "examples": [
    {
      "scenario": "Late registration surge before keynote day",
      "note": "AI should prioritize event registration constraints, waitlist behavior, and session capacity controls."
    },
    {
      "scenario": "Hybrid attendee support during live broadcast disruption",
      "note": "AI should map requests to venue plus virtual fallback workflows while preserving direct service event model assumptions."
    }
  ],
  "properties": {
    "eventCategory": "conference",
    "audienceScale": "large",
    "requiresRegistration": true,
    "supportsWaitlist": true,
    "supportsTicketTransfer": true,
    "contactPoints": [
      {
        "contactType": "customer_service",
        "telephone": "+1-415-555-0151",
        "email": "attendee-support@summitpulse-event.example",
        "url": "https://summitpulse-event.example/support",
        "areaServed": "global",
        "availableLanguages": [
          "en",
          "es",
          "fr"
        ]
      },
      {
        "contactType": "sales",
        "telephone": "+1-415-555-0164",
        "email": "sponsors@summitpulse-event.example",
        "url": "https://summitpulse-event.example/sponsors",
        "areaServed": "global",
        "availableLanguages": [
          "en"
        ]
      }
    ],
    "socialProfiles": [
      {
        "platform": "linkedin",
        "url": "https://www.linkedin.com/company/summit-pulse",
        "username": "summit-pulse"
      },
      {
        "platform": "youtube",
        "url": "https://youtube.com/@summitpulse",
        "username": "summitpulse"
      },
      {
        "platform": "twitter",
        "url": "https://twitter.com/summitpulseconf",
        "username": "summitpulseconf"
      }
    ],
    "identifiers": [
      {
        "type": "url",
        "value": "https://summitpulse-event.example"
      },
      {
        "type": "custom",
        "value": "EVNT-SPG-2026"
      }
    ]
  },
  "capabilities": {
    "interaction": {
      "features": [
        "messaging",
        "commenting",
        "notifications"
      ],
      "interactionMethods": [
        "online_form",
        "chat",
        "email"
      ],
      "availableActions": [
        "register",
        "manage_ticket",
        "view_agenda",
        "join_stream",
        "contact_support"
      ],
      "hasMessaging": true,
      "hasComments": true,
      "hasRating": false,
      "hasReviews": false,
      "hasSocialGraph": false,
      "hasFeed": true,
      "hasNotifications": true,
      "hasMatching": false,
      "realTimeCommunication": true,
      "moderationEnabled": true,
      "privacyControls": [
        "public",
        "private"
      ]
    },
    "booking": {
      "features": [
        "reservation",
        "availabilityCheck",
        "scheduling",
        "instantBooking",
        "waitlist",
        "cancellation",
        "reminder"
      ],
      "acceptsReservations": true,
      "requiresDeposit": false,
      "cancellationPolicy": "7_days",
      "minimumAdvanceBooking": "PT1H",
      "maximumAdvanceBooking": "P180D",
      "realTimeFeatures": [
        "real_time_availability",
        "instant_confirmation"
      ],
      "bookingChannels": [
        "website",
        "mobile_app"
      ]
    },
    "content": {
      "features": [
        "publishing",
        "curation",
        "mediaHosting",
        "search",
        "categories",
        "tags"
      ],
      "contentTypes": [
        "agenda",
        "speaker_profile",
        "session_recording",
        "faq"
      ],
      "contentFormats": [
        "text",
        "html",
        "mp4",
        "pdf"
      ],
      "contentAccess": [
        "public",
        "member"
      ],
      "editorialControl": true,
      "userGeneratedContent": false,
      "mediaHosting": true,
      "searchPossible": true,
      "hasCategorization": true,
      "hasTagging": true,
      "archiveAccess": true,
      "rssFeeds": false
    },
    "financial": {
      "features": [
        "payments",
        "invoicing",
        "refunds",
        "billing",
        "subscriptionManagement"
      ],
      "paymentMethods": [
        "credit_card",
        "debit_card",
        "digital_wallet",
        "bank_transfer"
      ],
      "acceptsCreditCards": true,
      "currencies": [
        "USD",
        "EUR"
      ],
      "priceRange": "tiered_ticketing",
      "commissionModel": "fixed_price",
      "commissionRate": 0,
      "supportsSubscriptions": true,
      "supportsInvoicing": true,
      "refundPolicy": "partial_refund"
    },
    "community": {
      "features": [
        "groups",
        "channels",
        "communities",
        "discovery",
        "groupEvents",
        "polls"
      ],
      "supportsGroups": true,
      "supportsChannels": true,
      "communitiesCount": 24,
      "hasDiscovery": true,
      "hasModeration": true,
      "moderationModel": "human",
      "hasMembershipManagement": true,
      "membershipTypes": [
        "attendee",
        "speaker",
        "sponsor"
      ],
      "supportsGroupEvents": true,
      "supportsPolls": true,
      "hasGovernance": true,
      "governanceModel": "centralized",
      "privacyLevels": [
        "public",
        "closed"
      ]
    }
  },
  "modules": {
    "registration": {
      "registrationOpenDate": "2026-04-01T16:00:00Z",
      "registrationCloseDate": "2026-09-22T12:00:00Z",
      "approvalWorkflowEnabled": true
    },
    "agenda": {
      "multiTrackEnabled": true,
      "sessionCapacityControlEnabled": true,
      "speakerManagementEnabled": true
    },
    "venue": {
      "physicalAddress": {
        "streetAddress": "1200 Embarcadero Plaza",
        "addressLocality": "San Francisco",
        "addressRegion": "CA",
        "postalCode": "94111",
        "addressCountry": "US"
      },
      "geoCoordinates": {
        "latitude": 37.7956,
        "longitude": -122.3937,
        "accuracy": 8
      },
      "virtualVenueUrl": "https://stream.summitpulse-event.example/live"
    }
  },
  "structuralMetadata": {
    "topology": "binary",
    "roles": [
      "user",
      "platform"
    ],
    "valueSource": "platform_provided",
    "transactionFlow": "direct",
    "networkEffects": "none",
    "temporalBounded": "yes"
  },
  "targetAudience": [
    "technology_leaders",
    "product_managers",
    "engineers",
    "operations_teams"
  ],
  "siteCapabilities": {
    "supportedDevices": [
      "desktop",
      "mobile",
      "tablet"
    ],
    "languages": [
      "en",
      "es",
      "fr"
    ],
    "accessibilityFeatures": [
      "keyboard_navigation",
      "screen_reader_labels",
      "caption_support",
      "text_scaling"
    ]
  },
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "example_instance",
    "status": "reference",
    "lastValidated": "2026-02-20T18:48:00Z",
    "validator": "META-AIML SDK v3"
  },
  "semanticAnnotations": {
    "classificationRationale": "Event is modeled as EventEntity plus DirectService because organizers directly provide bounded temporal experiences to registered participants.",
    "disambiguationNotes": "This is not a listing-only catalog. It includes first-party registration, agenda, and venue operations under one event service contract.",
    "intendedUse": "Canonical filled reference for event organizations that publish static schema in website headers."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "reference",
    "sdkValidationRules": [
      "RULE-EVGF-001: @type MUST equal \"Event\"",
      "RULE-EVGF-002: ontologicalMode MUST equal \"EventEntity\"",
      "RULE-EVGF-003: interactionArchetype MUST contain exactly one value: \"DirectService\"",
      "RULE-EVGF-004: eventDetails MUST include startDate, endDate, and eventType",
      "RULE-EVGF-005: modules.registration, modules.agenda, and modules.venue MUST be present",
      "RULE-EVGF-006: capabilities MUST include interaction and booking groups",
      "RULE-EVGF-007: structuralMetadata constants MUST align with DirectService archetype",
      "RULE-EVGF-008: examples MUST contain at least two realistic operational scenarios"
    ]
  }
}

All entities RidesharingService OnlineBanking