openapi: 3.1.0
info:
  title: Ticket
  version: 2.0.0
  description: Schema definition for the Ticket entity in the Beckn Mobility domain.
  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:
    Ticket:
      type: object
      title: Ticket
      description: A document or digital record granting the holder the right to travel
        on a specific transport service or within a defined validity scope.
      x-tags:
        - mobility
        - schema-org
        - ride-hailing
      properties:
        ticketId:
          description: Unique identifier or serial number of the ticket
          type: string
        ticketType:
          description: Type of ticket (e.g. SINGLE, RETURN, SEASON, FLEXI)
          type: string
        validFrom:
          description: Date and time from which the ticket is valid
          type: string
          format: date-time
        validUntil:
          description: Date and time until which the ticket is valid
          type: string
          format: date-time
        fareProductRef:
          description: Reference to the fare product this ticket is issued under
          $ref: https://schema.beckn.io/FareProduct/v2.0/attributes.yaml#/components/schemas/FareProduct
        passengerRef:
          description: Reference to the passenger this ticket is issued to
          $ref: https://schema.beckn.io/Passenger/v2.0/attributes.yaml#/components/schemas/Passenger
        id:
          description: Unique identifier for the entitlement
          type: string
        descriptor:
          description: Human-readable information about the entitlement
          $ref: https://schema.beckn.io/core/v2.0/Descriptor/attributes.yaml#components/schemas/Descriptor
        resource:
          description: The resource being accessed against this entitlement
          $ref: https://schema.beckn.io/ContractItem/v2.0/attributes.yaml#/components/schemas/ContractItem
        credentials:
          description: Credential descriptors for the entitlement
          $ref: https://schema.beckn.io/core/v2.0/Descriptor/attributes.yaml#components/schemas/Descriptor
      additionalProperties: false