Organization Base Schema

v2.0.1
Base Schema

Foundation schema for all organization entities in META-AIML. Provides common structure and properties for businesses, institutions, and establishments with physical or virtual presence.

6

Entity Types

3

Required Fields

40%

Web Coverage

Purpose & Usage

The Organization base schema defines the common structure for all business entities, institutions, and establishments. It provides:

Core Identity

Essential identification fields including legal names, registration numbers, and tax identifiers.

Multilingual Support

Built-in internationalization for names and descriptions across multiple languages.

Semantic Web Ready

JSON-LD compatibility with @context, @id, and @type for linked data integration.

Extensible Design

Foundation for specialized organization types with additionalProperties support.

Schema Structure
Base organization schema with required and optional properties
organization.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Organization Base Schema",
  "description": "Base schema for all organization entities in AIML",
  "aimlVersion": "2.0.1",
  "schemaVersion": "2.0.1",
  "type": "object",
  "properties": {
    "@context": {
      "type": "string",
      "format": "uri",
      "description": "JSON-LD context for semantic web integration"
    },
    "@id": {
      "type": "string",
      "format": "uri",
      "description": "Unique identifier for this instance"
    },
    "@type": {
      "type": "string",
      "description": "Pascal Case entity type (Hotel, Restaurant, etc.)"
    },
    "entityType": {
      "type": "string",
      "description": "Specific type of organization entity"
    },
    "entityCategory": {
      "type": "string",
      "const": "organization",
      "description": "Top-level category of entity"
    },
    "name": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Organization name (supports multilingual)"
    },
    "description": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Organization description (supports multilingual)"
    },
    "identifier": {
      "type": "object",
      "properties": {
        "legalName": { "type": "string" },
        "taxID": { "type": "string" },
        "vatID": { "type": "string" },
        "registrationNumber": { "type": "string" }
      }
    }
  },
  "required": ["entityType", "name", "description"]
}
Required Fields
Essential properties that must be present in all organization schemas
Required
entityType

Specific type of organization (restaurant, hotel, clinic, etc.). Must match one of the supported entity types.

Required
name

Organization name. Can be a simple string or multilingual object with language codes (en, es, etc.).

Required
description

Detailed description of the organization. Supports multilingual format for international businesses.

Supported Entity Types
Organization entities that inherit from this base schema
clinic
Organization

Healthcare clinics and medical facilities

education_platform
Organization

Educational institutions and platforms

fitness_platform
Organization

Fitness centers and wellness platforms

hotel
Organization

Hotels and accommodation services

restaurant
Organization

Restaurants and food service establishments

store
Organization

Physical or digital retail stores

Schema URL
Direct access to the organization base schema
https://schemas.meta-aiml.org/v2.0.1/base/organization.json

Referenced via allOf in entity schemas to inherit base properties

← All Base SchemasRestaurant Entity →Hotel Entity →