openapi: 3.0.2
info:
  title: Digital Battery Passport API
  description: This OpenApi allows users to query data contained in a digital passport.
  license:
    name: MIT
  version: 1.0.0
externalDocs:
  description: More about Digital Passport
  url: https://docu.digital-passport.org
servers: null
tags:
  - name: BatteryPass
paths:
  /batterypass:
    get:
      tags:
        - BatteryPass
      summary: >-
        Get a list of all available digital battery passports. The contents of
        the list might be subjective to access control
      responses:
        '200':
          description: List of all available codelists
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BatteryPassResponse'
    post:
      tags:
        - BatteryPass
      summary: Add a new digital battery passport
      requestBody:
        description: Definition of a new digital battery passport
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatteryPass'
      responses:
        '200':
          description: Metadata of the created BatteryPass
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatteryPassResponse'
        '500':
          description: 'Error: Unspecified error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
  /batterypass/{batteryIDDMCCode}:
    get:
      tags:
        - BatteryPass
      summary: Get the metadata of a given batteryPass
      parameters:
        - in: path
          name: batteryIDDMCCode
          description: Identifier of the BatteryPass that is requested
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Metadata of the BatteryPass
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatteryPassResponse'
        '500':
          description: 'Error: Unspecified error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
    post:
      tags:
        - BatteryPass
      summary: Update an BattPassport
      parameters:
        - in: path
          name: batteryIDDMCCode
          description: Identifier of the BatteryPass that is updated
          required: true
          schema:
            type: string
      requestBody:
        description: Definition of a new digital battery passport
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatteryPass'
      responses:
        '200':
          description: Metadata of the updated BatteryPass
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatteryPassResponse'
        '500':
          description: 'Error: Unspecified error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
  /batterypass/{batteryIDDMCCode}/electrochemicalProperties:
    get:
      tags:
        - ElectrochemicalProperties
      summary: Get the Eelectrochemical properties of a given batteryPass
      parameters:
        - in: path
          name: batteryIDDMCCode
          description: Identifier of the BatteryPass that is requested
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Eelectrochemical properties of a given batteryPass
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectrochemicalProperties'
        '500':
          description: 'Error: Unspecified error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
    post:
      tags:
        - ElectrochemicalProperties
      summary: Update the electrochemical properties in a batteryPass
      parameters:
        - in: path
          name: batteryIDDMCCode
          description: Identifier of the BatteryPass that is updated
          required: true
          schema:
            type: string
      requestBody:
        description: Definition of the updated ElectrochemicalProperties
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ElectrochemicalProperties'
      responses:
        '200':
          description: Metadata of the updated BatteryPass
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectrochemicalProperties'
        '500':
          description: 'Error: Unspecified error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
  /batterypass/{batteryIDDMCCode}/compositionProperties:
    get:
      tags:
        - CompositionProperties
      summary: Get the composition properties of a given batteryPass
      parameters:
        - in: path
          name: batteryIDDMCCode
          description: Identifier of the BatteryPass that is requested
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Composition properties of a given batteryPass
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompositionProperties'
        '500':
          description: 'Error: Unspecified error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
    post:
      tags:
        - CompositionProperties
      summary: Update the composition properties in a batteryPass
      parameters:
        - in: path
          name: batteryIDDMCCode
          description: Identifier of the BatteryPass that is updated
          required: true
          schema:
            type: string
      requestBody:
        description: Definition of the updated CompositionProperties
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompositionProperties'
      responses:
        '200':
          description: Metadata of the updated CompositionProperties
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompositionProperties'
        '500':
          description: 'Error: Unspecified error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
  /batterypass/{batteryIDDMCCode}/batteryCycleLifeProperties:
    get:
      tags:
        - BatteryCycleLifeProperties
      summary: Get the batteryCycleLife properties of a given batteryPass
      parameters:
        - in: path
          name: batteryIDDMCCode
          description: Identifier of the BatteryPass that is requested
          required: true
          schema:
            type: string
      responses:
        '200':
          description: BatteryCycleLife properties of a given batteryPass
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatteryCycleLifeProperties'
        '500':
          description: 'Error: Unspecified error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
    post:
      tags:
        - BatteryCycleLifeProperties
      summary: Update the batteryCycleLifeProperties properties in a batteryPass
      parameters:
        - in: path
          name: batteryIDDMCCode
          description: Identifier of the BatteryPass that is updated
          required: true
          schema:
            type: string
      requestBody:
        description: Definition of the updated BatteryCycleLifeProperties
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatteryCycleLifeProperties'
      responses:
        '200':
          description: Metadata of the updated BatteryCycleLifeProperties
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatteryCycleLifeProperties'
        '500':
          description: 'Error: Unspecified error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
  /batterypass/{batteryIDDMCCode}/cellChemistryProperties:
    get:
      tags:
        - CellChemistryProperties
      summary: Get the cellChemistry properties of a given batteryPass
      parameters:
        - in: path
          name: batteryIDDMCCode
          description: Identifier of the BatteryPass that is requested
          required: true
          schema:
            type: string
      responses:
        '200':
          description: cellChemistry properties of a given batteryPass
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CellChemistryProperties'
        '500':
          description: 'Error: Unspecified error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
    post:
      tags:
        - CellChemistryProperties
      summary: Update the cellChemistry properties in a batteryPass
      parameters:
        - in: path
          name: batteryIDDMCCode
          description: Identifier of the BatteryPass that is updated
          required: true
          schema:
            type: string
      requestBody:
        description: Definition of the updated CellChemistryProperties
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CellChemistryProperties'
      responses:
        '200':
          description: Metadata of the updated BatteryCycleLifeProperties
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CellChemistryProperties'
        '500':
          description: 'Error: Unspecified error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
components:
  schemas:
    ErrorMessage:
      type: object
      properties:
        internal_id:
          type: integer
          description: Error number within the program
        error_text:
          type: string
          description: Some optional message
    BatteryPassResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/BatteryPass'
    BatteryPass:
      type: object
      properties:
        batteryIDDMCCode:
          type: string
          description: Battery IDDM Code
        dateOfManufacturing:
          description: >-
            Manufacturing date (month and year), suggested in form of
            manufacturing date codes.
          type: string
        dateOfService:
          type: string
          description: Date of putting the battery into service
        placeOfManufacturing:
          type: string
          description: >-
            Unambiguous identification of the manufacturing facility (e.g.
            country, city, street, building (if needed)), suggested via a unique
            facility identifier (as unique string of characters for the
            identification of locations or buildings involved in the value chain
            of a product or used by actors involved in the value chain of a
            product, ESPR Art. 2(33)).
        cO2FootprintTotal:
          type: number
          format: double
          description: CO2 Footprint Total (kg CO2)
        hasEelectrochemicalProperties:
          $ref: '#/components/schemas/ElectrochemicalProperties'
        hasPhysicalDimensionsProperties:
          $ref: '#/components/schemas/PhysicalDimensionsProperties'
        hasCellChemistryProperties:
          $ref: '#/components/schemas/CellChemistryProperties'
        hasBatteryEnergyProperties:
          $ref: '#/components/schemas/BatteryEnergyProperties'
        safetyMeasures:
          $ref: '#/components/schemas/Attachement'
        hasBatteryCycleLifeProperties:
          $ref: '#/components/schemas/BatteryCycleLifeProperties'
        hasStateOfBatteryProperties:
          $ref: '#/components/schemas/StateOfBatteryProperties'
        hasCompositionProperties:
          $ref: '#/components/schemas/CompositionProperties'
        warrantyPeriod:
          type: number
          description: >-
            Warranty period of the battery. Also includes the expected life-time
            under the reference conditions in calendar years.
        meaningLabelsAndSymbols:
          $ref: '#/components/schemas/Attachement'
        separateCollectionSymbol:
          $ref: '#/components/schemas/Attachement'
        carbonFootprintPerformanceClass:
          type: string
          description: >-
            EV, industrial and LMT batteries shall bear a conspicuous, clearly
            legible and indelible label indicating the carbon footprint
            performance class that the relevant battery model per manufacturing
            plant corresponds to. The carbon footprint performance class shall
            be accessible via the battery passport. A meaningful number of
            classes of performance will be developed, with category A being the
            best class with the lowest carbon footprint life cycle impact.
        carbonFootprintStudyLink:
          type: string
          description: >-
            A web link to get access to a public version of the study supporting
            the carbon footprint values
        manualDissasemblyAndDismantlingBatteryPack:
          $ref: '#/components/schemas/Attachement'
        manualRemovalBatteryFromAppliance:
          $ref: '#/components/schemas/Attachement'
        dueDiligenceReport:
          $ref: '#/components/schemas/Attachement'
        extinguishingAgent:
          type: string
          description: >-
            Usable extinguishing agend refering to classes of extinguishers (A,
            B, C, D, K).
        remainingPowerCapability:
          type: number
          description: >-
            Remaining performance ability of the high voltage battery i.e. the
            amount of energy that a battery is capable to provide over a given
            period of time
        hasRenewableContentShare:
          type: array
          items:
            $ref: '#/components/schemas/RenewableContentShare'
        hasPreConsumerRecycledMaterialShare:
          type: array
          items:
            $ref: '#/components/schemas/RenewableContentShare'
        hasPostConsumerRecycledMaterialShare:
          type: array
          items:
            $ref: '#/components/schemas/RenewableContentShare'
        encounteredNegativeEvents:
          type: number
          description: The number of encountered negative events (such as accidents)
        batteryCategory:
          type: string
          description: >-
            Categories relevant for the battery passport: `LMT battery`,
            `electric vehicle battery` or `industrial battery`. The latter
            includes the subcategory `stationary battery energy storage system`
            complemented by `other industrial batteries` (Art. 2).
        declarationOfConformityID:
          type: string
          description: >-
            Identification number of the EU declaration of conformity of the
            battery, linked to the  Battery Carbon Footprint Declaration.
        roleOfEndUsersInWastePrevention:
          $ref: '#/components/schemas/Attachement'
        roleOfEndUsersInSeparateCollectionOfWasteBatteries:
          $ref: '#/components/schemas/Attachement'
        informationOnSeparateCollectionTakeBackCollectionPointsPreparingForReusePreparingForRepurposingAndRecyclingOperations:
          $ref: '#/components/schemas/Attachement'
        temperatureRangeIdleState:
          $ref: '#/components/schemas/Interval'
        timeSpentInExtremeTemperatures:
          $ref: '#/components/schemas/Interval'
        timeSpentChargingDuringExtremeTemperatures:
          $ref: '#/components/schemas/Interval'
    RenewableContentShare:
      type: object
      description: ''
      properties:
        recycledMaterialShareName:
          type: string
          description: Recycled Material Share Name
        recycledMaterialShareAmount:
          type: number
          description: Recycled Material Share Amount (percent)
    CompositionProperties:
      type: object
      description: Composition Properties
      properties:
        componentsProperties:
          type: array
          items:
            $ref: '#/components/schemas/ComponentsProperties'
        leadSymbol:
          type: boolean
          description: >-
            Lead symbol indicating the metal is contained in the battery above a
            defined threshold of 0.004%
        cadmiumSymbol:
          type: boolean
          description: >-
            Cadmium symbol indicating the metal is contained in the battery
            above a defined threshold of 0.002%
        criticalRawMaterials:
          type: string
          description: ''
        compositionOfBattery:
          $ref: '#/components/schemas/Attachement'
    ComponentsProperties:
      type: object
      description: Components Properties
      properties:
        involvedSupplierComponents:
          $ref: '#/components/schemas/JudicialPersonIdentification'
        involvedComponentsPartsNumber:
          type: string
          description: The unique serial numbers of the different parts of a battery
    JudicialPersonIdentification:
      type: object
      description: Judicial Person Identification
      properties:
        manufacturerWebsite:
          type: string
          description: Website of the Manufacturer
        manufacturerEmail:
          type: string
          description: Email of the Manufacturer
        manufacturerName:
          type: string
          description: Name of the Manufacturer
        manufacturerAddress:
          type: string
          description: Postal Address of the Manufacturer
        manufacturerPhoneNumber:
          type: string
          description: Phone Number of the Manufacturer
        manufacturerTradeDetails:
          type: string
          description: >-
            Trade details of the manufacturer: trade name or registered
            trademark
    StateOfBatteryProperties:
      type: object
      description: ''
      properties:
        statusBattery:
          type: string
          description: Status of the battery. Value list provided by the regulators.
        stateOfHealth:
          type: number
          description: >-
            Evidence/Certificate of the health evaluation of a battery for its
            use following repurposing or remanufacturing operations
        stateOfCharge:
          type: number
          description: >-
            The value of the state of charge of the battery at the end of life
            i.e. when entering recycling scheme
    BatteryCycleLifeProperties:
      type: object
      description: Battery Cycle Life Properties
      properties:
        expectedLifetime:
          type: number
          description: >-
            Expected battery lifetime expressed in cycles, and reference test
            used
        cycleLifeTestCRate:
          type: number
          description: C-rate of Relevant Cycle-life Test
        cycleLifeTestDepthOfDischarge:
          type: number
          description: Depth of discharge in the cycle-life test
        chargeDischargeCycles:
          type: number
          description: Number of (full) charging and discharging cycles.
        energyThroughput:
          type: number
          description: >-
            Overall sum of the energy throughput over the battery lifetime. The
            data attribute should be reported as measured for further potential
            processing. In addition, the normalisation by usable battery energy
            could add a further useful value that ensures comparability among
            battery sizes.
        capacityThroughput:
          type: number
          description: >-
            Overall sum of the capacity throughput over the battery lifetime.
            The data attribute should be reported as measured for further
            potential processing. In addition, the normalisation by capacity
            could add a further useful value that ensures comparability among
            battery sizes.
        cycleLifeReferenceTest:
          type: string
          description: Specification of the applied cycle-life test.
    Attachement:
      type: object
      description: ''
      properties:
        attachementName:
          type: string
          description: Name of the attached file
    BatteryEnergyProperties:
      type: object
      description: Battery Energy Properties
      properties:
        energyRoundtripEfficiency:
          type: number
          description: >-
            Round-trip efficiency is the percentage of electricity put into
            storage.
        energyRoundtripEfficiencyChange:
          type: number
          description: The current amount energy round-trip efficiency fade (in %).
        maximumAllowedBatteryEnergy:
          type: number
          description: Maximum allowed battery energy (Wh) of the battery.
        initialSelfDischargingRate:
          type: number
          description: >-
            Initial self-discharge in % of capacity per unit of time in defined
            conditions (temperature range etc) as pre-use metric.
        currentSelfDischargingRate:
          type: number
          description: >-
            Current self-discharge in % of capacity per unit of time in defined
            conditions (temperature range) during the use phase.
        evolutionSelfDischargingRate:
          type: number
          description: >-
            The increase of self-discharging rates in the use-phase as
            percentage with reference to the initial self-discharging rate.
        certifiedUsableBatteryEnergy:
          type: number
          description: >-
            Definition from UNECE GTR 22, applicable only to EVs. The energy
            supplied by the battery from the beginning of the test procedure
            used for certification until the applicable break-off criterion of
            the test procedure used for certification is reached.
        remainingUsableBatteryEnergy:
          type: number
          description: >-
            Definition from UNECE GTR 22, applicable only to EVs.The UBE
            determined at the present point in the lifetime of the vehicle by
            the test procedure used for certification.
        stateOfCertifiedEnergy:
          type: number
          description: >-
            Definition based on UNECE GTR 22: The measured or on-board UBE
            performance at a specific point in its lifetime, expressed as a
            percentage of the certified usable battery energy.
        roundTripEnergyEfficiencyAt50CycleLife:
          type: number
          description: >-
            Round trip energy efficiency at 50% of cycle-life; measured at 50%
            of cycle life as determined in a pre-use standardized measurement.
        remainingRoundTripEnergyEfficiency:
          type: number
          description: >-
            Remaining round trip energy efficiency during the use-phase;
            definition of round-trip energy efficiency as provided in Battery
            Regulation.
    ElectrochemicalProperties:
      type: object
      description: ''
      properties:
        ratedCapacity:
          type: number
          description: >-
            The total number of ampere-hours (Ah) that can be withdrawn from a
            fully charged battery under specific conditions
        capacityFade:
          type: number
          description: >-
            The decrease over time and upon usage in the amount of charge that a
            battery can deliver at the rated voltage, with respect to the
            original rated capacity declared by the manufacturer
        capacityThresholdExhaustion:
          type: number
          description: Capacity threshold for exhaustion as percentage value
        ratioMaximumAllowedBatteryPowerAndMaximumAllowedBatteryEnergy:
          type: number
          description: >-
            Ratio between maximum allowed battery power (W) and battery energy
            (Wh)
        remainingCapacity:
          type: number
          description: >-
            The total remaining number of ampere-hours (Ah) that can be
            withdrawn from a fully charged battery under specific conditions
        internalResistanceProperties:
          $ref: '#/components/schemas/InternalResistanceProperties'
        voltageProperties:
          $ref: '#/components/schemas/VoltageProperties'
        batteryPowerProperties:
          $ref: '#/components/schemas/BatteryPowerProperties'
        temperatureProperties:
          $ref: '#/components/schemas/TemperatureProperties'
        SOCEThresholdForExhaustion:
          type: number
          description: >-
            Derived as analogue to, and potential future replacement of
            `Capacity threshold for exhaustion`. Interpreted as minimum
            percentage of SOCE, above which the battery is still considered
            operational as EV battery in its current life. The value has to be
            provided by the economic operator. The SOCE standard is only
            applicable to electric vehicle batteries. This metric may serve as
            indicator for a necessary end of current life as EV and may be
            understood in the context of warranty. A clarified definition is
            required.
    TemperatureProperties:
      type: object
      description: Temperature Properties
      properties:
        environmentalOperatingTemperature:
          type: number
          description: >-
            The environmental operating temperature should be periodically
            (daily frequency) available.
        averageTemperatureUsage:
          type: number
          description: >-
            The average battery temperature shoud be available (that the battery
            has been used in)
        minimalTemperatureUsage:
          type: number
          description: >-
            The minimal battery temperature shoud be available (that the battery
            has been used in)
        maximumTemperatureUsage:
          type: number
          description: >-
            The maximum battery temperature shoud be available (that the battery
            has been used in)
        averageTemperatureCharging:
          type: number
          description: The average battery temperature during charging should be available.
        minimalTemperatureCharging:
          type: number
          description: The minimal battery temperature during charging should be available.
        maximumTemperatureCharging:
          type: number
          description: The maximum battery temperature during charging should be available.
    VoltageProperties:
      type: object
      description: ''
      properties:
        minVoltage:
          type: string
          description: Value of the minimal voltage the battery is rated for.
        nomimalVoltage:
          type: string
          description: Value of the nominal voltage the battery is rated for.
        maxVoltage:
          type: string
          description: Value of the maximum voltage the battery is rated for.
        minimalOperatinCurrent:
          type: number
          description: >-
            The minimal operating current should be available (in which the
            battery has been used in, to detect abuse)
        maximumOperatingCurrent:
          type: number
          description: >-
            The maximum operating current should be available (in which the
            battery has been used in, to detect abuse)
    InternalResistanceProperties:
      type: object
      description: ''
      properties:
        cellInternalResistance:
          type: number
          description: The resistance offered by the cell in the flow of the current
        cellInternalResistanceCurrent:
          type: number
          description: >-
            Current (in-use) internal resistance on battery cell level, if
            possible. Definition of internal resistance equal to regulation
            definition.
        cellInternalResistanceIncrease:
          type: number
          description: >-
            Internal resistance increase on battery cell level, if possible.
            Calculated from initial and current internal resistance on battery
            cell level.
        packInternalResistance:
          type: number
          description: The resistance offered by the cell in the flow of the current
        packInternalResistanceIncrease:
          type: number
          description: The resistance offered by the cell in the flow of the current
        packInternalResistanceCurrent:
          type: number
          description: >-
            Current (in-use) internal resistance on battery pack level, if
            possible. Definition of internal resistance equal to regulation
            definition.
        deepDischargeEvents:
          type: number
          description: >-
            Number of deep discharge events.The criteria to qualify an event as
            'deep discharge' must be defined and consider different battery
            designs.
        overchargeEvents:
          type: number
          description: >-
            Number of overcharge events. The criteria to qualify an event as
            'overcharge' must be defined and consider different battery designs.
        moduleInternalResistanceInitial:
          type: number
          description: >-
            Initial (pre-use) internal resistance on battery module level.
            Definition of internal resistance equal to regulation definition.
        moduleInternalResistanceIncrease:
          type: number
          description: >-
            Internal resistance increase on battery module level, if possible.
            Calculated from initial and current internal resistance on battery
            module level.
        moduleInternalResistanceCurrent:
          type: number
          description: >-
            Current (in-use) internal resistance on battery module level, if
            possible. Definition of internal resistance equal to regulation
            definition.
    CellChemistryProperties:
      type: object
      description: Cell Chemistry Properties
      properties:
        cathodeActiveMaterials:
          type: array
          description: >-
            The total amount of valuable materials contained in CAM material:
            Nickel, Cobalt, Lithium.
          items:
            $ref: >-
              #/components/schemas/MaterialNameAndWeightAndPercentageMassFraction
        recyclateContentActiveMaterials:
          type: array
          items:
            $ref: >-
              #/components/schemas/MaterialNameAndWeightAndPercentageMassFraction
          description: >-
            List of recovered Recyclate Content in Active Material Recycled is
            describing a regulatory requirement. The following materials have to
            be reported on as a minimium: Cobalt, Lithium, Nickel, Lead
        anodeActiveMaterials:
          type: array
          items:
            $ref: >-
              #/components/schemas/MaterialNameAndWeightAndPercentageMassFraction
          description: 'The total amount of valuable materials contained in Anode: graphite'
        cathodeCompositionOther:
          type: array
          items:
            $ref: >-
              #/components/schemas/MaterialNameAndWeightAndPercentageMassFraction
          description: The composition or materials contained in the Cathode
        anodeCompositionOther:
          type: array
          items:
            $ref: >-
              #/components/schemas/MaterialNameAndWeightAndPercentageMassFraction
          description: The composition or materials contained in the anode
        electrolyteComposition:
          type: array
          items:
            $ref: >-
              #/components/schemas/MaterialNameAndWeightAndPercentageMassFraction
          description: List of materials contained in the electrolyte
        declarationOfConformity:
          $ref: '#/components/schemas/Attachement'
        testReportsResults:
          $ref: '#/components/schemas/Attachement'
    BatteryPowerProperties:
      type: object
      description: Battery Power Properties
      properties:
        powerFade:
          type: number
          description: Power Fade (percent)
        maximumAllowedBatteryPower:
          type: number
          description: Maximum Allowed Battery Power (W)
        powerCapabilityAt20Charge:
          type: number
          description: >-
            Power (capability) at 20% state of charge. Description from the
            regulation
        powerCapabilityAt80Charge:
          type: number
          description: >-
            Power (capability) at 80% state of charge. Description from the
            regulation
        originalPowerCapability:
          type: number
          description: >-
            Performance ability of the high voltage battery i.e. the amount of
            energy that a battery is capable to provide over a given period of
            time
        originalPowerCapabilityLimits:
          type: number
          description: >-
            Performance ability of the high voltage battery according to limits
            i.e. how much power it can provide within given limits
    MaterialNameAndWeightAndPercentageMassFraction:
      type: object
      description: Material Name And Weight And Percentage Mass Fraction
      properties:
        materialPercentageMassFraction:
          type: number
          description: Material Percentage Mass Fraction
        materialName:
          type: string
          description: Material Name
        materialWeight:
          type: number
          description: Material Weight (grams)
        hazardousProperties:
          $ref: '#/components/schemas/HazardousProperties'
    HazardousProperties:
      type: object
      description: Hazardous Properties of a Material
      properties:
        hazardCategory:
          type: string
          description: >-
            Specify hazard classes and/ or categories of hazardous substances
            (as`any substance that poses a threat to human health and the
            environment`) as defined by the CLP Regulation
        hazardIdentifiers:
          type: string
          description: >-
            CAS number and CLP Regulation index number of all hazardous
            substance (as `any substance that poses a threat to human health and
            the environment`)
        locationHazardousSubstance:
          type: string
          description: >-
            Location on a (sub-)component-level of all hazardous substances (as
            `any substance that poses a threat to human health and the
            environment`). Suggested via a unique identifier or nomenclature.
        concentrationRangeOfHazardousSubstances:
          type: string
          description: >-
            Concentration range of all hazardous substances (as `any substance
            that poses a threat to human health and the environment`) in %, per
            (sub-)component of the battery, based on SCIP concentration ranges
            in weight by weight.
        impactOfSubstances:
          type: string
          description: >-
            Impact statements based on, e.g., REACH or GHS for all hazard
            classes applicable to substances in the battery.
    Interval:
      type: object
      description: Interval
      properties:
        lowerBound:
          type: number
          description: Lower Bound
        upperBound:
          type: number
          description: Upper Bound
    PhysicalDimensionsProperties:
      type: object
      description: ''
      properties:
        length:
          type: number
          description: Length (millimetre)
        width:
          type: number
          description: Width (millimetre)
        height:
          type: number
          description: Height (millimetre)
        diameter:
          type: number
          description: Diameter (millimetre)
        weight:
          type: number
          description: Weight (millimetre)
