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.

RidesharingService

v3.0.0

DigitalEntity

Transportation

v3 schema for ride-hailing and ridesharing platforms that mediate transportation transactions between riders and drivers through real-time dispatch and pricing systems.

Top-level required

Required modules

Capability groups

Entity properties

Canonical Files

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

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

Inheritance Chain

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

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

Interaction archetype

MediatedExchange

Required Top-level Fields

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

@type

ontologicalMode

interactionArchetype

domain

name

description

deliveryFormat

capabilities

structuralMetadata

modules

Non-universal required fields

interactionArchetype

Entity-specific Properties

Keys under properties.properties dedicated to this entity contract.

contactPoints

driverVerificationModel

identifiers

rideTypes

socialProfiles

supportsCarpooling

supportsScheduledRides

surgePricingEnabled

Modules Contract

Required modules

No required modules for this entity.

Optional modules

dispatch

payments

safety

Capabilities Contract

Required capability groups

commerce

financial

interaction

Optional capability groups

community

location

Governance Validation Rules

Normative rule list from governanceMetadata.sdkValidationRules.

RULE-RIDE-001: @type MUST equal "RidesharingService"

RULE-RIDE-002: ontologicalMode MUST equal "DigitalEntity"

RULE-RIDE-003: interactionArchetype MUST contain "MediatedExchange"

RULE-RIDE-004: capabilities MUST include commerce, financial, interaction

RULE-RIDE-005: structuralMetadata.topology MUST equal "triadic"

RULE-RIDE-006: structuralMetadata.transactionFlow MUST equal "escrow"

Canonical Contract JSON

https://schemas.meta-aiml.org/v3.0.0/entity/ridesharing_service.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/ridesharing_service.json",
  "$id": "https://schemas.meta-aiml.org/v3.0.0/entity/ridesharing_service.json",
  "@type": "RidesharingService",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Ridesharing Service Entity Schema",
  "description": "v3 schema for ride-hailing and ridesharing platforms that mediate transportation transactions between riders and drivers through real-time dispatch and pricing systems.",
  "examples": [
    {
      "description": "Urban ridesharing app with dynamic pricing and instant driver matching",
      "reference": "ridesharing_service_example_urban"
    },
    {
      "description": "Regional ride platform with scheduled pickups and airport transfer flows",
      "reference": "ridesharing_service_example_regional"
    }
  ],
  "type": "object",
  "additionalProperties": false,
  "allOf": [
    {
      "$ref": "../ontology/digital_entity.json"
    },
    {
      "$ref": "../archetypes/mediated_exchange.json"
    }
  ],
  "properties": {
    "@type": {
      "const": "RidesharingService"
    },
    "ontologicalMode": {
      "const": "DigitalEntity"
    },
    "interactionArchetype": {
      "type": "array",
      "contains": {
        "const": "MediatedExchange"
      },
      "items": {
        "type": "string",
        "enum": [
          "MediatedExchange"
        ]
      }
    },
    "domain": {
      "const": "Transportation"
    },
    "businessModel": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Commission",
          "DynamicPricing",
          "Subscription"
        ]
      }
    },
    "deliveryFormat": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "MobileApp",
          "WebApp",
          "API"
        ]
      }
    },
    "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": {
        "rideTypes": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "economy",
              "premium",
              "shared",
              "xl",
              "eco"
            ]
          }
        },
        "supportsScheduledRides": {
          "type": "boolean"
        },
        "supportsCarpooling": {
          "type": "boolean"
        },
        "surgePricingEnabled": {
          "type": "boolean"
        },
        "driverVerificationModel": {
          "type": "string",
          "enum": [
            "basic",
            "enhanced",
            "continuous_monitoring"
          ]
        },
        "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": [
        "commerce",
        "financial",
        "interaction"
      ],
      "properties": {
        "commerce": {
          "$ref": "../components/capability_groups.json#/$defs/CommerceCapabilities"
        },
        "financial": {
          "$ref": "../components/capability_groups.json#/$defs/FinancialCapabilities"
        },
        "interaction": {
          "$ref": "../components/capability_groups.json#/$defs/InteractionCapabilities"
        },
        "location": {
          "$ref": "../components/capability_groups.json#/$defs/LocationCapabilities"
        },
        "community": {
          "$ref": "../components/capability_groups.json#/$defs/CommunityCapabilities"
        }
      }
    },
    "modules": {
      "type": "object",
      "properties": {
        "dispatch": {
          "type": "object",
          "properties": {
            "autoMatchingEnabled": {
              "type": "boolean"
            },
            "etaPredictionEnabled": {
              "type": "boolean"
            },
            "demandRebalancingEnabled": {
              "type": "boolean"
            }
          }
        },
        "safety": {
          "type": "object",
          "properties": {
            "sosFeatureEnabled": {
              "type": "boolean"
            },
            "tripMonitoringEnabled": {
              "type": "boolean"
            },
            "anomalyAlertsEnabled": {
              "type": "boolean"
            }
          }
        },
        "payments": {
          "type": "object",
          "properties": {
            "instantDriverPayouts": {
              "type": "boolean"
            },
            "tipProcessingEnabled": {
              "type": "boolean"
            },
            "settlementCycleDays": {
              "type": "integer",
              "minimum": 0
            }
          }
        }
      }
    },
    "structuralMetadata": {
      "type": "object",
      "properties": {
        "topology": {
          "const": "triadic"
        },
        "roles": {
          "const": [
            "buyer",
            "seller",
            "platform"
          ]
        },
        "valueSource": {
          "const": "transaction_mediation"
        },
        "transactionFlow": {
          "const": "escrow"
        },
        "networkEffects": {
          "const": "cross_side"
        },
        "matchingMechanism": {
          "type": "string",
          "enum": [
            "nearest_driver",
            "score_based",
            "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",
    "capabilities",
    "structuralMetadata",
    "modules"
  ],
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "entity",
    "status": "draft",
    "lastValidated": "2026-02-20T12:00:00Z",
    "validator": "META-AIML QA"
  },
  "semanticAnnotations": {
    "classificationRationale": "RidesharingService is DigitalEntity + MediatedExchange because value comes from matching riders and drivers with platform-managed transaction and routing logic.",
    "disambiguationNotes": "Different from transportation operators with owned fleet acting as DirectService. This schema models platform mediation between independent sides."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "draft",
    "sdkValidationRules": [
      "RULE-RIDE-001: @type MUST equal \"RidesharingService\"",
      "RULE-RIDE-002: ontologicalMode MUST equal \"DigitalEntity\"",
      "RULE-RIDE-003: interactionArchetype MUST contain \"MediatedExchange\"",
      "RULE-RIDE-004: capabilities MUST include commerce, financial, interaction",
      "RULE-RIDE-005: structuralMetadata.topology MUST equal \"triadic\"",
      "RULE-RIDE-006: structuralMetadata.transactionFlow MUST equal \"escrow\""
    ]
  }
}

Filled Example Instance

https://schemas.meta-aiml.org/v3.0.0/examples/ridesharing_service_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/ridesharing_service/cityloop-mobility",
  "$id": "https://data.meta-aiml.org/v3.0.0/examples/ridesharing_service/cityloop-mobility",
  "@type": "RidesharingService",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Example Filled Ridesharing Service Example (CityLoop Mobility)",
  "ontologicalMode": "DigitalEntity",
  "interactionArchetype": [
    "MediatedExchange"
  ],
  "domain": "Transportation",
  "businessModel": [
    "Commission",
    "DynamicPricing",
    "Subscription"
  ],
  "deliveryFormat": [
    "MobileApp",
    "WebApp",
    "API"
  ],
  "name": {
    "en": "CityLoop Mobility",
    "es": "CityLoop Mobility",
    "fr": "CityLoop Mobility"
  },
  "description": {
    "en": "CityLoop Mobility is a fictional ridesharing platform mediating ride transactions between riders and verified drivers with real-time dispatch, route optimization, and safety escalation workflows.",
    "es": "CityLoop Mobility es una plataforma ficticia de ridesharing que media viajes entre pasajeros y conductores verificados con despacho en tiempo real y flujos de seguridad.",
    "fr": "CityLoop Mobility est une plateforme fictive de covoiturage a la demande qui medie les trajets entre passagers et conducteurs verifies avec dispatch temps reel et securite."
  },
  "shortDescription": {
    "en": "Ride-hailing marketplace with real-time dispatch, dynamic pricing, and trust-and-safety controls.",
    "es": "Marketplace de transporte con despacho en tiempo real, precio dinamico y controles de seguridad.",
    "fr": "Place de marche de transport avec dispatch temps reel, tarification dynamique et controles de surete."
  },
  "url": "https://cityloop-mobility.example",
  "foundingDate": "2019-07-04",
  "createdDate": "2026-02-20T20:32:00Z",
  "lastModified": "2026-02-20T20:32:00Z",
  "examples": [
    {
      "scenario": "Airport demand spike during holiday weekend",
      "note": "AI should prioritize mediated matching, surge pricing logic, and ETA reliability rather than modeling rides as direct fleet operations."
    },
    {
      "scenario": "Night safety escalation for delayed trip",
      "note": "AI should route through SOS, trip monitoring, and anomaly alert modules while preserving rider and driver role boundaries."
    }
  ],
  "properties": {
    "rideTypes": [
      "economy",
      "premium",
      "shared",
      "xl",
      "eco"
    ],
    "supportsScheduledRides": true,
    "supportsCarpooling": true,
    "surgePricingEnabled": true,
    "driverVerificationModel": "continuous_monitoring",
    "contactPoints": [
      {
        "contactType": "support",
        "telephone": "+1-415-555-0177",
        "email": "support@cityloop-mobility.example",
        "url": "https://cityloop-mobility.example/help",
        "areaServed": "US",
        "availableLanguages": [
          "en",
          "es"
        ]
      },
      {
        "contactType": "technical",
        "telephone": "+1-415-555-0122",
        "email": "safety@cityloop-mobility.example",
        "url": "https://cityloop-mobility.example/safety",
        "areaServed": "US",
        "availableLanguages": [
          "en"
        ]
      }
    ],
    "socialProfiles": [
      {
        "platform": "twitter",
        "url": "https://twitter.com/cityloopmobility",
        "username": "cityloopmobility"
      },
      {
        "platform": "instagram",
        "url": "https://instagram.com/cityloopmobility",
        "username": "cityloopmobility"
      },
      {
        "platform": "linkedin",
        "url": "https://www.linkedin.com/company/cityloop-mobility",
        "username": "cityloop-mobility"
      }
    ],
    "identifiers": [
      {
        "type": "url",
        "value": "https://cityloop-mobility.example"
      },
      {
        "type": "custom",
        "value": "RIDE-CLM-001"
      }
    ]
  },
  "capabilities": {
    "commerce": {
      "features": [
        "checkout",
        "orderTracking",
        "pricing",
        "search",
        "filtering",
        "listingManagement"
      ],
      "hasProductCatalog": false,
      "catalogSize": 0,
      "supportsCart": false,
      "supportsCheckout": true,
      "hasOrderTracking": true,
      "recommendationEngine": true,
      "vendorManagement": true,
      "searchCapability": true,
      "filteringOptions": [
        "ride_type",
        "price",
        "eta",
        "accessibility"
      ]
    },
    "financial": {
      "features": [
        "payments",
        "invoicing",
        "refunds",
        "wallet",
        "billing",
        "subscriptionManagement",
        "escrow"
      ],
      "paymentMethods": [
        "credit_card",
        "debit_card",
        "digital_wallet",
        "bank_transfer"
      ],
      "acceptsCreditCards": true,
      "currencies": [
        "USD"
      ],
      "priceRange": "dynamic",
      "commissionModel": "percentage",
      "commissionRate": 18.5,
      "supportsSubscriptions": true,
      "supportsInvoicing": true,
      "refundPolicy": "partial_refund"
    },
    "interaction": {
      "features": [
        "messaging",
        "rating",
        "reviews",
        "notifications",
        "matching"
      ],
      "interactionMethods": [
        "in_app_messaging",
        "chat",
        "online_form"
      ],
      "availableActions": [
        "request_ride",
        "schedule_ride",
        "share_trip",
        "contact_driver",
        "report_issue"
      ],
      "hasMessaging": true,
      "hasComments": false,
      "hasRating": true,
      "hasReviews": true,
      "hasSocialGraph": false,
      "hasFeed": false,
      "hasNotifications": true,
      "hasMatching": true,
      "realTimeCommunication": true,
      "moderationEnabled": true,
      "privacyControls": [
        "private",
        "semi_anonymous"
      ]
    },
    "location": {
      "features": [
        "geoCoordinates",
        "proximitySearch",
        "realTimeTracking",
        "routing"
      ],
      "hasPhysicalAddress": false,
      "hasGeoCoordinates": true,
      "hasMultipleLocations": true,
      "hasParking": false,
      "parkingType": "street",
      "isWheelchairAccessible": true,
      "publicTransitAccess": true,
      "deliveryZones": [
        "san_francisco",
        "oakland",
        "san_jose"
      ],
      "serviceRadius": 120
    },
    "community": {
      "features": [
        "groups",
        "communities",
        "discovery",
        "moderation",
        "membershipManagement"
      ],
      "supportsGroups": true,
      "supportsChannels": false,
      "communitiesCount": 66,
      "hasDiscovery": true,
      "hasModeration": true,
      "moderationModel": "human",
      "hasMembershipManagement": true,
      "membershipTypes": [
        "rider",
        "driver",
        "fleet_partner"
      ],
      "supportsGroupEvents": false,
      "supportsPolls": false,
      "hasGovernance": true,
      "governanceModel": "centralized",
      "privacyLevels": [
        "public",
        "closed"
      ]
    }
  },
  "modules": {
    "dispatch": {
      "autoMatchingEnabled": true,
      "etaPredictionEnabled": true,
      "demandRebalancingEnabled": true
    },
    "safety": {
      "sosFeatureEnabled": true,
      "tripMonitoringEnabled": true,
      "anomalyAlertsEnabled": true
    },
    "payments": {
      "instantDriverPayouts": true,
      "tipProcessingEnabled": true,
      "settlementCycleDays": 1
    },
    "tripData": {
      "tripDiscovery": {
        "canonicalTripStatusUrl": "https://cityloop-mobility.example/trip-status",
        "dataSources": [
          {
            "sourceType": "public_api_endpoint",
            "sourceUrl": "https://cityloop-mobility.example/public/trip-policies.json",
            "format": "json",
            "updateCadence": "daily"
          }
        ]
      }
    }
  },
  "structuralMetadata": {
    "topology": "triadic",
    "roles": [
      "buyer",
      "seller",
      "platform"
    ],
    "valueSource": "transaction_mediation",
    "transactionFlow": "escrow",
    "networkEffects": "cross_side",
    "matchingMechanism": "hybrid"
  },
  "targetAudience": [
    "commuters",
    "airport_travelers",
    "night_shift_workers",
    "drivers"
  ],
  "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:32:00Z",
    "validator": "META-AIML SDK v3"
  },
  "semanticAnnotations": {
    "classificationRationale": "RidesharingService is modeled as DigitalEntity plus MediatedExchange because rider-driver matching and transaction mediation are the core value mechanics.",
    "disambiguationNotes": "This model is not a direct taxi fleet service schema. It represents multi-party matching, trip mediation, and platform-governed payouts.",
    "intendedUse": "Canonical filled reference for ridesharing platforms publishing static AI-readable architecture metadata."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "reference",
    "sdkValidationRules": [
      "RULE-RSGF-001: @type MUST equal \"RidesharingService\"",
      "RULE-RSGF-002: ontologicalMode MUST equal \"DigitalEntity\"",
      "RULE-RSGF-003: interactionArchetype MUST contain exactly one value: \"MediatedExchange\"",
      "RULE-RSGF-004: capabilities MUST include commerce, financial, and interaction groups",
      "RULE-RSGF-005: modules.dispatch, modules.safety, and modules.payments MUST be present",
      "RULE-RSGF-006: structuralMetadata constants MUST align with MediatedExchange archetype",
      "RULE-RSGF-007: examples MUST include at least two operational scenarios",
      "RULE-RSGF-008: schema MUST NOT expose credential or secret fields"
    ]
  }
}

All entities WebsiteServices Event