ConnectorWithPricing
Represents a physical charging connector (cable or socket) on an EVSE with active and original pricing information
The format (socket/cable) of the installed connector. Enum: SOCKET, CABLE.
Unique identifier for the connector, which should never be changed or modified. For example, the database ID.
CPO's identifier for the connector. Usually meant to be human readable.
Timestamp when this connector was last updated (or created). Format: RFC3339 in UTC timezone.
Maximum amperage of the connector, in ampere [A]. Used for calculating charging power and compatibility.
Maximum electric power that can be delivered by this connector, in Watts (W). Calculated from voltage and amperage.
Maximum voltage of the connector (line to neutral for AC_3_PHASE), in volt [V]. Common values: 230V (AC), 400V (DC).
Type of power available at this connector. Enum: AC_1_PHASE, AC_2_PHASE, AC_2_PHASE_SPLIT, AC_3_PHASE, DC.
The standard of the installed connector. Enum: CHADEMO, IEC_60309_2_single_16, IEC_60309_2_three_16, IEC_60309_2_three_32, IEC_60309_2_three_64, IEC_62196_T1, IEC_62196_T1_COMBO, IEC_62196_T2, IEC_62196_T2_COMBO, IEC_62196_T3A, IEC_62196_T3C, TESLA_R, TESLA_S.
Identifiers of the currently valid charging tariffs. Multiple tariffs are possible, but only one of each Tariff.type can be active at the same time. For a "free of charge" tariff, this field should be set and point to a defined "free of charge" tariff.
Terms of use, contractual agreements, and conditions that govern the usage of the connector. May include URLs to full terms documents.
Indicates the current status of the connector. Enum: AVAILABLE, PREPARING, CHARGING, FINISHING, INOPERATIVE, OUTOFORDER, PLANNED, REMOVED, RESERVED, UNKNOWN.
The consistency and dependability of the connector over time. Range: 0.0 to 10.0, where 10.0 is most reliable.
The amount of time the connector is operational and available for charging sessions. Range: 0.0 to 1.0, where 1.0 is 100% uptime.
String that is usually printed as a QR code or as a short label. Used to navigate to the charger on the UI, either through a QR scanner or by being keyed in.
Indicates access restrictions for this connector. Enum: PUBLIC, PRIVATE, RESTRICTED.
Whether the charger is online. Not supported by all CPOs. If it is unsupported, it will be null.
Human readable string identifying the charger gun. Usually a short name such as "Gun A" or "Connector 1".
Determines whether this connector can be used for charging. Disabled connectors cannot start new sessions.
Determines whether this connector should be shown on the UI. Unpublished connectors are hidden from public views.
Determines whether this connector supports transient web payments. For example: Guest Checkout, Pay-as-you-go, etc.
active_tariff ActiveTariff
Represents an active pricing tariff for charging sessions. Defines the pricing structure including energy, time, flat fees, and idle charges.
ISO-4217 currency code for this tariff.
Unique identifier for the tariff.
Type of tariff (e.g., AD_HOC_PAYMENT, REGULAR).
price_per_kwh Price
price_per_min Price
price_flat Price
price_per_min_parked Price
price_modifiers OMNIPriceModifier[]
List of price modifiers that can adjust the base tariff.
price_platform_flat Price
elements TariffElement[]
List of tariff elements with time/power restrictions.
price_components PriceComponent[]
restrictions TariffRestrictions
original_tariff ActiveTariff
Represents an active pricing tariff for charging sessions. Defines the pricing structure including energy, time, flat fees, and idle charges.
ISO-4217 currency code for this tariff.
Unique identifier for the tariff.
Type of tariff (e.g., AD_HOC_PAYMENT, REGULAR).
price_per_kwh Price
price_per_min Price
price_flat Price
price_per_min_parked Price
price_modifiers OMNIPriceModifier[]
List of price modifiers that can adjust the base tariff.
price_platform_flat Price
elements TariffElement[]
List of tariff elements with time/power restrictions.
price_components PriceComponent[]
restrictions TariffRestrictions
{
"format": "string",
"uid": "string",
"connector_id": "string",
"last_updated": "string",
"max_amperage": 0,
"max_electric_power": 0,
"max_voltage": 0,
"power_type": "string",
"standard": "string",
"tariff_uids": [
"string"
],
"terms_and_conditions": "string",
"status": "string",
"reliability": 0,
"uptime": 0,
"qr_identifier": "string",
"privilege_status": "string",
"online": true,
"physical_reference": "string",
"is_enabled": true,
"is_published": true,
"is_transient_web_enabled": true,
"active_tariff": {
"currency": "string",
"uid": "string",
"type": "string",
"price_per_kwh": {
"excl_vat": 0,
"incl_vat": 0
},
"price_per_min": {
"excl_vat": 0,
"incl_vat": 0
},
"price_flat": {
"excl_vat": 0,
"incl_vat": 0
},
"price_per_min_parked": {
"excl_vat": 0,
"incl_vat": 0
},
"price_modifiers": [
{
"uid": "string",
"value": 0,
"type": "string",
"vat": 0,
"tariff_dimension_types": [
"string"
]
}
],
"price_platform_flat": {
"excl_vat": 0,
"incl_vat": 0
},
"elements": [
{
"uid": "string",
"price_components": [
{
"type": "string",
"price": 0,
"vat": 0,
"step_size": "string"
}
],
"restrictions": {
"start_time": "string",
"end_time": "string",
"start_date": "string",
"end_date": "string",
"min_kwh": 0,
"max_kwh": 0,
"min_current": 0,
"max_current": 0,
"min_power": 0,
"max_power": 0,
"min_duration": "string",
"max_duration": "string",
"day_of_week": [
"string"
],
"reservation": "string",
"max_average_power": 0,
"reservation_min_kwh": 0,
"reservation_max_kwh": 0,
"advance_booking_days_min": "string",
"advance_booking_days_max": "string"
},
"session_stage": "string"
}
]
},
"original_tariff": {
"currency": "string",
"uid": "string",
"type": "string",
"price_per_kwh": {
"excl_vat": 0,
"incl_vat": 0
},
"price_per_min": {
"excl_vat": 0,
"incl_vat": 0
},
"price_flat": {
"excl_vat": 0,
"incl_vat": 0
},
"price_per_min_parked": {
"excl_vat": 0,
"incl_vat": 0
},
"price_modifiers": [
{
"uid": "string",
"value": 0,
"type": "string",
"vat": 0,
"tariff_dimension_types": [
"string"
]
}
],
"price_platform_flat": {
"excl_vat": 0,
"incl_vat": 0
},
"elements": [
{
"uid": "string",
"price_components": [
{
"type": "string",
"price": 0,
"vat": 0,
"step_size": "string"
}
],
"restrictions": {
"start_time": "string",
"end_time": "string",
"start_date": "string",
"end_date": "string",
"min_kwh": 0,
"max_kwh": 0,
"min_current": 0,
"max_current": 0,
"min_power": 0,
"max_power": 0,
"min_duration": "string",
"max_duration": "string",
"day_of_week": [
"string"
],
"reservation": "string",
"max_average_power": 0,
"reservation_min_kwh": 0,
"reservation_max_kwh": 0,
"advance_booking_days_min": "string",
"advance_booking_days_max": "string"
},
"session_stage": "string"
}
]
}
}