openapi: 3.1.0
info:
  title: SurgeMultiplier
  version: 2.0.0
  description: Schema definition for the SurgeMultiplier entity in the Beckn Mobility
  license:
    name: CC-BY-NC-SA 4.0 International
    url: https://creativecommons.org/licenses/by-nc-sa/4.0/deed.en
  contact:
    name: Beckn Labs
    url: https://beckn.io
components:
  schemas:
    SurgeMultiplier:
      x-iri: https://schema.nfh.global/SurgeMultiplier/v2.0
      type: object
      title: SurgeMultiplier
      description: A dynamic pricing factor applied during periods of high demand
        that increases base fares proportionally to balance supply and demand.
      x-tags:
        - mobility
        - ride-hailing
      properties:
        multiplierValue:
          description: The surge multiplier value (e.g. 1.5 for 1.5x surge)
          type: number
        validUntil:
          description: Timestamp until which the surge multiplier is active
          type: string
          format: date-time
        reason:
          description: Reason for the surge (e.g. HIGH_DEMAND, SPECIAL_EVENT)
          type: string
        geofenceRef:
          description: Geographic area where the surge pricing applies
          $ref: https://schema.nfh.global/Geofence/v2.0/attributes.yaml#/components/schemas/Geofence
        title:
          description: Title or label of this price component
          type: string
        price:
          description: Monetary value of this component
          $ref: https://schema.nfh.global/PriceSpecification/v2.1/attributes.yaml#/components/schemas/PriceSpecification
        tags:
          description: Tags associated with this price component
          type: string
      additionalProperties: false