PerformanceAndDurabilityEV (v2)

Download OpenAPI specification:

PerformanceAndDurabilityEV

getPerformanceAndDurabilityEV

path Parameters
tenantId
required
string <uuid>

The ID of the tenant owning the requested Twin.

passportIdentifier
required
string <uuid>
Example: 550e8400-e29b-41d4-a716-446655440000

The Battery Passport ID

Responses

Response samples

Content type
application/json
{
  • "negativeEventsEV": {
    },
  • "remainingCapacity": {
    },
  • "soce": {
    },
  • "capacityFade": {
    },
  • "fullCycles": {
    },
  • "remainingEnergy": {
    },
  • "temperatureCondition": {
    },
  • "stateOfCharge": {
    },
  • "resistanceByPack": {
    },
  • "resistanceByCell": {
    },
  • "resistanceByModule": {
    },
  • "powerCapabilityFade": 0,
  • "remainingPowerCapability": 0,
  • "roundTripEfficiencyFade": {
    }
}

putPerformanceAndDurabilityEV

path Parameters
tenantId
required
string <uuid>

The ID of the tenant owning the requested Twin.

passportIdentifier
required
string <uuid>
Example: 550e8400-e29b-41d4-a716-446655440000

The Battery Passport ID

Request Body schema: application/json
required
required
object

Information on accidents.

object

The remaining capacity in the battery expressed in ampere hours. This attribute is mentioned in the Battery Regulation 2023/1542 from 12 July 2023 in Annex XIII (4) (b) refers to Article 14, refers to Annex VII Part A:

  1. the remaining capacity.
required
object

The state of certified energy (SOCE) refers to the current measured or on-board usable battery energy (UBE) performance expressed as a percentage. This attribute is mentioned in the Battery regulation 2023/1542 from 12 July 2023 in Annex XIII (4)(b) refers to Article 14) and refers to Annex VII Part A: state of certified energy (SOCE).

required
object

Capacity fade refers to a reduction in the capacity of the battery system over time expressed as a percentage in reference to the initial value. This attribute is mentioned in the Battery regulation 2023/1542 from 12 July 2023 in Annex XIII (4)(a) refers to Article 10(1) and refer to Annex IV Part A:

  1. Rated capacity (in Ah) and capacity fade (in %). Definition from Annex IV: (2) "Capacity fade" means 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.
required
object

Full cycles include the cumulative and equivalent count of complete charge and discharge cycles experienced by the battery over its entire life. This attribute is mentioned in the Battery Regulation 2023/1542 from 12 July 2023 in Annex XIII (4) (d) information and data resulting from its use, including the number of charging and discharging cycles and negative events, such as accidents, as well as periodically recorded information on the operating environmental conditions, including temperature, and on the state of charge. And in AnnexVII Part B: 5. the number of full equivalent charge-discharge cycles.

object

The remaining energy in the battery expressed in kilowatt-hours.

required
object

property for battery temperature

required
object

State of Charge (SOC) refers to the amount of energy remaining in a battery at a given point in time, expressed as a percentage of the total capacity. This attribute is mentioned in the Battery regulation 2023/1542 from 12 July 2023 in Annex XIII (4): (d) information and data resulting from its use, including the number of charging and discharging cycles and negative events, such as accidents, as well as periodically recorded information on the operating environmental conditions, including temperature, and on the state of charge.

required
object

internal resistance information of pack

object

“Internal battery cell and pack resistance”/“Internal resistance (in ?) by Cell.” “Internal resistance” means the opposition to the flow of current within a cell or a battery, that is, the sum of electronic resistance and ionic resistance to the contribution to total effective resistance including inductive/capacitive properties.

object

internal resistance information of module

powerCapabilityFade
required
integer

In-use power fade, as defined in Battery Regulation; Annex IV Part B, point 4 --> measurement at 80 % and 20 % SoC required. This requirement may not be implementable and should be reviewed together with SoC definition.

remainingPowerCapability
integer

Remaining (in-use) power capability: Definition of power capability as provided in Battery Regulation. Annex IV Part B, point 4 --> measurement at 80 % and 20 % SoC required. This requirement may not be implementable and should be reviewed together with SoC definition.

required
object

Round trip efficiency fade refers to a reduction in the round trip efficiency of the battery system over time expressed as a percentage in reference to the initial value. This attribute is mentioned in the Battery regulation 2023/1542 from 12 July 2023 in Annex XIII (4)(a) refers to Article 10(1) and refers to Annex IV: 4. Where applicable, energy round trip efficiency and its fade (in %). Definition from Annex IV: (6) "Energy round trip efficiency" means the ratio of the net energy delivered by a battery during a discharge test to the total energy required to restore the initial state of charge by a standard charge.

Responses

Request samples

Content type
application/json
{
  • "negativeEventsEV": {
    },
  • "remainingCapacity": {
    },
  • "soce": {
    },
  • "capacityFade": {
    },
  • "fullCycles": {
    },
  • "remainingEnergy": {
    },
  • "temperatureCondition": {
    },
  • "stateOfCharge": {
    },
  • "resistanceByPack": {
    },
  • "resistanceByCell": {
    },
  • "resistanceByModule": {
    },
  • "powerCapabilityFade": 0,
  • "remainingPowerCapability": 0,
  • "roundTripEfficiencyFade": {
    }
}

Response samples

Content type
application/json
{
  • "negativeEventsEV": {
    },
  • "remainingCapacity": {
    },
  • "soce": {
    },
  • "capacityFade": {
    },
  • "fullCycles": {
    },
  • "remainingEnergy": {
    },
  • "temperatureCondition": {
    },
  • "stateOfCharge": {
    },
  • "resistanceByPack": {
    },
  • "resistanceByCell": {
    },
  • "resistanceByModule": {
    },
  • "powerCapabilityFade": 0,
  • "remainingPowerCapability": 0,
  • "roundTripEfficiencyFade": {
    }
}