Price Groups
Retrieve a list of price groups.
Required scope: price-groups:read
Organization authorization: supported
query Parameters
teamIdFilter by team id. When omitted, returns all price groups owned by the consumer's operator.
typeFilter by price group type. Multiple values supported.
pricingTypeFilter by pricing type. Multiple values supported.
searchFree-text search filter by price group name. Max 200 characters.
pagePage number to retrieve (starts with 0)
perPageNumber of items per page (between 1 and 100, default 10)
Retrieve a list of price groups. › Responses
List of price groups that match the criteria
Creates a price group
Required scope: price-groups:write
Organization authorization: supported
Creates a price group › Request Body
nameName of the price group
typeType of the price group
The master price
teamIdTeam ID. When omitted the price group is created at operator scope and owned by the calling operator.
All the fees for the price group
Creates a price group › Responses
Price group successfully created
idId of the price group
nameName of the price group
typeType of the price group
The master price
Tariffs of the price group
createdAtWhen the price group was created
teamIdId of the team for which this price group belongs
defaultFees of the price group
teamMemberCountTo how many team members the price group has been applied to
chargePointCountTo how many charge points the price group has been applied to
updatedAtWhen the price group was updated
Bulk remove a tariff from all price groups
⚠️ Destructive bulk operation. Removes the specified tariff from ALL price groups within the operator's scope — both operator-owned and team-owned. This cannot be undone via the API. You must send {"confirm": true} in the request body to acknowledge the impact before the operation proceeds. Required scope: price-groups:delete
Organization authorization: supported
path Parameters
tariffIdBulk remove a tariff from all price groups › Request Body
confirmMust be true to confirm this bulk destructive operation. Omitting this field or setting it to false will result in a 422 error.
Bulk remove a tariff from all price groups › Responses
Tariff successfully removed from all price groups
Retrieve a price group.
Required scope: price-groups:read
Organization authorization: supported
path Parameters
idRetrieve a price group. › Responses
Price group with provided id
idId of the price group
nameName of the price group
typeType of the price group
The master price
Tariffs of the price group
createdAtWhen the price group was created
teamIdId of the team for which this price group belongs
defaultFees of the price group
teamMemberCountTo how many team members the price group has been applied to
chargePointCountTo how many charge points the price group has been applied to
updatedAtWhen the price group was updated
Updates a price group
Required scope: price-groups:write
Organization authorization: supported
path Parameters
idUpdates a price group › Request Body
nameName of the price group
typeType of the price group
The master price
teamIdTeam ID. When omitted the price group is created at operator scope and owned by the calling operator.
All the fees for the price group
Updates a price group › Responses
Price group successfully updated
idId of the price group
nameName of the price group
typeType of the price group
The master price
Tariffs of the price group
createdAtWhen the price group was created
teamIdId of the team for which this price group belongs
defaultFees of the price group
teamMemberCountTo how many team members the price group has been applied to
chargePointCountTo how many charge points the price group has been applied to
updatedAtWhen the price group was updated
List teams the price group has been applied to.
Returns paginated teams within the price group's scope, each with counts of applied members and charge points. Required scope: price-groups:read
Organization authorization: supported
path Parameters
idquery Parameters
Limit results to teams owned by the listed operator ids (must be within the price group owner's operator hierarchy). Ignored for team-owned price groups.
searchFree-text filter on team name (case-insensitive prefix match). Max 255 characters.
pagePage number to retrieve (starts with 0).
perPageNumber of items per page (between 1 and 100, default 10).
List teams the price group has been applied to. › Responses
Paginated teams the price group is applied to.
Apply price group to charge points, sites or team members
For operator-owned price groups, pass teamId to apply to that team only, or omit it to apply across every team under the operator. Required scope: price-groups:write
Organization authorization: supported
path Parameters
idApply price group to charge points, sites or team members › Request Body
selectedChargePointIdsList of charge point ids
selectedSiteIdsList of site ids
selectedTeamMemberIdsList of team member ids
resetCostFlag to indicate if costs should be reset
teamIdTeam to apply the price group to. Only relevant for operator-owned price groups: if provided, the price group is applied to that team only; if omitted, it is applied across every team under the operator.
Apply price group to charge points, sites or team members › Responses
Price group successfully applied to the selected entities
idId of the price group
nameName of the price group
typeType of the price group
The master price
Tariffs of the price group
createdAtWhen the price group was created
teamIdId of the team for which this price group belongs
defaultFees of the price group
teamMemberCountTo how many team members the price group has been applied to
chargePointCountTo how many charge points the price group has been applied to
updatedAtWhen the price group was updated
List charge points in a price group.
Returns paginated charge points within the price group's operator scope that share the price group's currency. Required scope: price-groups:read
Organization authorization: supported
path Parameters
idquery Parameters
pagePage number to retrieve (starts with 0).
perPageNumber of items per page (between 1 and 100, default 10).
List charge points in a price group. › Responses
Paginated charge points within the price group's scope.
Sets a price group as default
For operator-owned price groups, pass teamId to name the team whose default should be flipped. Team-owned price groups ignore it. Required scope: price-groups:write
Organization authorization: supported
path Parameters
idquery Parameters
teamIdTeam whose default the price group becomes. Required for operator-owned price groups, which have no team owner of their own; ignored for team-owned price groups.
Sets a price group as default › Responses
Price group successfully set as default
idId of the price group
nameName of the price group
typeType of the price group
The master price
Tariffs of the price group
createdAtWhen the price group was created
teamIdId of the team for which this price group belongs
defaultFees of the price group
teamMemberCountTo how many team members the price group has been applied to
chargePointCountTo how many charge points the price group has been applied to
updatedAtWhen the price group was updated
Add a fee to a price group
Required scope: price-groups:write
Organization authorization: supported
path Parameters
idAdd a fee to a price group › Request Body
typeType of the pricing. minute is used for Minute fee. min is used for the master price.
endAtFullyChargedUsed by the Minute fee. True means it will stop charging the fee when the charge is complete. False means it will stop charging the fee when the cable is unplugged
vatUsed by Spot Price. True means it will add 25% VAT in the price calculations
priceThe price of this Fee or Master price,
Note: the master price cannot be a negative value
descriptionName of the pricing. It is null when it's the master price
percentageUsed by Spot Price. It will multiply the fallback price by this percentage
tariffIdThe id of the selected Tariff
tagIdThe id of the selected charge pricing tag
applyAfterMinutesUsed by Charging, Minute and Idle Fees. After how many minutes the fee should start being applied.
priceMinUsed by spot price. The minimum that the raw spot price can be. This will be used in calculations if spot price is lower than this
priceMaxUsed by spot price. The maximum that the raw spot price can be. This will be used in calculations if spot price is higher than this
feePriceMaxUsed by Idle fee. The maximum the user will be charged for the idle fee
Used by spot price. Additional absolute money or percentages values to be added on top of the previous calculations
fromDateTime "from" time to which this pricing should apply from
toDateTime "to" time to which this pricing should apply to
intervalSpecifies the time resolution used for spot price calculations.
Note: Only has an effect if such resolution is available (, ie 15-min MTU from 30.09.25).
Grace periods during which idle fees are not applied
Add a fee to a price group › Responses
Fee successfully added, returns the updated price group
idId of the price group
nameName of the price group
typeType of the price group
The master price
Tariffs of the price group
createdAtWhen the price group was created
teamIdId of the team for which this price group belongs
defaultFees of the price group
teamMemberCountTo how many team members the price group has been applied to
chargePointCountTo how many charge points the price group has been applied to
updatedAtWhen the price group was updated
Update a fee in a price group
Required scope: price-groups:write
Organization authorization: supported
path Parameters
idfeeIdUpdate a fee in a price group › Request Body
typeType of the pricing. minute is used for Minute fee. min is used for the master price.
endAtFullyChargedUsed by the Minute fee. True means it will stop charging the fee when the charge is complete. False means it will stop charging the fee when the cable is unplugged
vatUsed by Spot Price. True means it will add 25% VAT in the price calculations
priceThe price of this Fee or Master price,
Note: the master price cannot be a negative value
descriptionName of the pricing. It is null when it's the master price
percentageUsed by Spot Price. It will multiply the fallback price by this percentage
tariffIdThe id of the selected Tariff
tagIdThe id of the selected charge pricing tag
applyAfterMinutesUsed by Charging, Minute and Idle Fees. After how many minutes the fee should start being applied.
priceMinUsed by spot price. The minimum that the raw spot price can be. This will be used in calculations if spot price is lower than this
priceMaxUsed by spot price. The maximum that the raw spot price can be. This will be used in calculations if spot price is higher than this
feePriceMaxUsed by Idle fee. The maximum the user will be charged for the idle fee
Used by spot price. Additional absolute money or percentages values to be added on top of the previous calculations
fromDateTime "from" time to which this pricing should apply from
toDateTime "to" time to which this pricing should apply to
intervalSpecifies the time resolution used for spot price calculations.
Note: Only has an effect if such resolution is available (, ie 15-min MTU from 30.09.25).
Grace periods during which idle fees are not applied
Update a fee in a price group › Responses
Fee successfully updated, returns the updated price group
idId of the price group
nameName of the price group
typeType of the price group
The master price
Tariffs of the price group
createdAtWhen the price group was created
teamIdId of the team for which this price group belongs
defaultFees of the price group
teamMemberCountTo how many team members the price group has been applied to
chargePointCountTo how many charge points the price group has been applied to
updatedAtWhen the price group was updated