Monta
Monta API

Price Groups


Retrieve a list of price groups.

GET
https://partner-api.monta.com
/api/v1/price-groups

Required scope: price-groups:read
Organization authorization: supported

Retrieve a list of price groups. › query Parameters

teamId
​integer · int64

Filter by team id. When omitted, returns all price groups owned by the consumer's operator.

type
​string · enum

Filter by price group type. Multiple values supported.

Enum values:
public
member
sponsored
cost
roaming
reimbursement
member_cost
other
pricingType
​string · enum

Filter by pricing type. Multiple values supported.

Enum values:
kwh
min
spot
tariff
fee
search
​string · maxLength: 200

Free-text search filter by price group name. Max 200 characters.

page
​integer · int32

Page number to retrieve (starts with 0)

Default: 0
perPage
​integer · int32

Number of items per page (between 1 and 100, default 10)

Default: 10

Retrieve a list of price groups. › Responses

List of price groups that match the criteria

​PriceGroup_1[] · required
​MontaPage.Meta · required

Creates a price group

POST
https://partner-api.monta.com
/api/v1/price-groups

Required scope: price-groups:write
Organization authorization: supported

Creates a price group › Request Body

name
​string · required

Name of the price group

Example: Public Price Group
type
​string · enum · required

Type of the price group

Enum values:
public
member
sponsored
cost
roaming
reimbursement
member_cost
other
Example: public
​object · required

The master price

teamId
​integer | null · int64

Team ID. When omitted the price group is created at operator scope and owned by the calling operator.

Example: 1
​array | null

All the fees for the price group

Creates a price group › Responses

Price group successfully created

id
​integer · int64 · required

Id of the price group

Example: 522
name
​string · required

Name of the price group

Example: Public Price Group
type
​string · enum · required

Type of the price group

Enum values:
public
member
sponsored
cost
roaming
reimbursement
member_cost
other
Example: public
​object · required

The master price

​array | null · required

Tariffs of the price group

​PriceGroupAppliedTo · required
createdAt
​string · date-time · required

When the price group was created

Example: 2023-03-16T15:37:23Z
teamId
​integer | null · int64

Id of the team for which this price group belongs

Example: 12
default
​boolean
​array | null

Fees of the price group

teamMemberCount
​integer | null · int32

To how many team members the price group has been applied to

chargePointCount
​integer | null · int32

To how many charge points the price group has been applied to

updatedAt
​string | null · date-time

When the price group was updated

Example: 2023-03-16T15:37:23Z

Bulk remove a tariff from all price groups

DELETE
https://partner-api.monta.com
/api/v1/price-groups/tariffs/{tariffId}

⚠️ 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

Bulk remove a tariff from all price groups › path Parameters

tariffId
​integer · int64 · required

Bulk remove a tariff from all price groups › Request Body

confirm
​boolean · required

Must be true to confirm this bulk destructive operation. Omitting this field or setting it to false will result in a 422 error.

Example: true

Bulk remove a tariff from all price groups › Responses

Tariff successfully removed from all price groups

No data returned

Retrieve a price group.

GET
https://partner-api.monta.com
/api/v1/price-groups/{id}

Required scope: price-groups:read
Organization authorization: supported

Retrieve a price group. › path Parameters

id
​integer · int64 · required

Retrieve a price group. › Responses

Price group with provided id

id
​integer · int64 · required

Id of the price group

Example: 522
name
​string · required

Name of the price group

Example: Public Price Group
type
​string · enum · required

Type of the price group

Enum values:
public
member
sponsored
cost
roaming
reimbursement
member_cost
other
Example: public
​object · required

The master price

​array | null · required

Tariffs of the price group

​PriceGroupAppliedTo · required
createdAt
​string · date-time · required

When the price group was created

Example: 2023-03-16T15:37:23Z
teamId
​integer | null · int64

Id of the team for which this price group belongs

Example: 12
default
​boolean
​array | null

Fees of the price group

teamMemberCount
​integer | null · int32

To how many team members the price group has been applied to

chargePointCount
​integer | null · int32

To how many charge points the price group has been applied to

updatedAt
​string | null · date-time

When the price group was updated

Example: 2023-03-16T15:37:23Z

Updates a price group

PUT
https://partner-api.monta.com
/api/v1/price-groups/{id}

Required scope: price-groups:write
Organization authorization: supported

Updates a price group › path Parameters

id
​integer · int64 · required

Updates a price group › Request Body

name
​string · required

Name of the price group

Example: Public Price Group
type
​string · enum · required

Type of the price group

Enum values:
public
member
sponsored
cost
roaming
reimbursement
member_cost
other
Example: public
​object · required

The master price

teamId
​integer | null · int64

Team ID. When omitted the price group is created at operator scope and owned by the calling operator.

Example: 1
​array | null

All the fees for the price group

Updates a price group › Responses

Price group successfully updated

id
​integer · int64 · required

Id of the price group

Example: 522
name
​string · required

Name of the price group

Example: Public Price Group
type
​string · enum · required

Type of the price group

Enum values:
public
member
sponsored
cost
roaming
reimbursement
member_cost
other
Example: public
​object · required

The master price

​array | null · required

Tariffs of the price group

​PriceGroupAppliedTo · required
createdAt
​string · date-time · required

When the price group was created

Example: 2023-03-16T15:37:23Z
teamId
​integer | null · int64

Id of the team for which this price group belongs

Example: 12
default
​boolean
​array | null

Fees of the price group

teamMemberCount
​integer | null · int32

To how many team members the price group has been applied to

chargePointCount
​integer | null · int32

To how many charge points the price group has been applied to

updatedAt
​string | null · date-time

When the price group was updated

Example: 2023-03-16T15:37:23Z

Deletes a price group

DELETE
https://partner-api.monta.com
/api/v1/price-groups/{id}

Required scope: price-groups:delete
Organization authorization: supported

Deletes a price group › path Parameters

id
​integer · int64 · required

Deletes a price group › Responses

Price group successfully deleted

No data returned

List teams the price group has been applied to.

GET
https://partner-api.monta.com
/api/v1/price-groups/{id}/applied-teams

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

List teams the price group has been applied to. › path Parameters

id
​integer · int64 · required

List teams the price group has been applied to. › query Parameters

​object

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.

search
​string · maxLength: 255

Free-text filter on team name (case-insensitive prefix match). Max 255 characters.

page
​integer · int32

Page number to retrieve (starts with 0).

Default: 0
perPage
​integer · int32

Number of items per page (between 1 and 100, default 10).

Default: 10

List teams the price group has been applied to. › Responses

Paginated teams the price group is applied to.

​AppliedPriceGroupTeam[] · required
​MontaPage.Meta · required

Apply price group to charge points, sites or team members

PUT
https://partner-api.monta.com
/api/v1/price-groups/{id}/apply

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

Apply price group to charge points, sites or team members › path Parameters

id
​integer · int64 · required

Apply price group to charge points, sites or team members › Request Body

selectedChargePointIds
​array | null

List of charge point ids

selectedSiteIds
​array | null

List of site ids

selectedTeamMemberIds
​array | null

List of team member ids

resetCost
​boolean | null

Flag to indicate if costs should be reset

teamId
​integer | null · int64

Team 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

id
​integer · int64 · required

Id of the price group

Example: 522
name
​string · required

Name of the price group

Example: Public Price Group
type
​string · enum · required

Type of the price group

Enum values:
public
member
sponsored
cost
roaming
reimbursement
member_cost
other
Example: public
​object · required

The master price

​array | null · required

Tariffs of the price group

​PriceGroupAppliedTo · required
createdAt
​string · date-time · required

When the price group was created

Example: 2023-03-16T15:37:23Z
teamId
​integer | null · int64

Id of the team for which this price group belongs

Example: 12
default
​boolean
​array | null

Fees of the price group

teamMemberCount
​integer | null · int32

To how many team members the price group has been applied to

chargePointCount
​integer | null · int32

To how many charge points the price group has been applied to

updatedAt
​string | null · date-time

When the price group was updated

Example: 2023-03-16T15:37:23Z

List charge points in a price group.

GET
https://partner-api.monta.com
/api/v1/price-groups/{id}/charge-points

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

List charge points in a price group. › path Parameters

id
​integer · int64 · required

List charge points in a price group. › query Parameters

page
​integer · int32

Page number to retrieve (starts with 0).

Default: 0
perPage
​integer · int32

Number of items per page (between 1 and 100, default 10).

Default: 10

List charge points in a price group. › Responses

Paginated charge points within the price group's scope.

​ChargePoint[] · required
​MontaPage.Meta · required

Sets a price group as default

PUT
https://partner-api.monta.com
/api/v1/price-groups/{id}/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

Sets a price group as default › path Parameters

id
​integer · int64 · required

Sets a price group as default › query Parameters

teamId
​integer · int64

Team 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

id
​integer · int64 · required

Id of the price group

Example: 522
name
​string · required

Name of the price group

Example: Public Price Group
type
​string · enum · required

Type of the price group

Enum values:
public
member
sponsored
cost
roaming
reimbursement
member_cost
other
Example: public
​object · required

The master price

​array | null · required

Tariffs of the price group

​PriceGroupAppliedTo · required
createdAt
​string · date-time · required

When the price group was created

Example: 2023-03-16T15:37:23Z
teamId
​integer | null · int64

Id of the team for which this price group belongs

Example: 12
default
​boolean
​array | null

Fees of the price group

teamMemberCount
​integer | null · int32

To how many team members the price group has been applied to

chargePointCount
​integer | null · int32

To how many charge points the price group has been applied to

updatedAt
​string | null · date-time

When the price group was updated

Example: 2023-03-16T15:37:23Z

Add a fee to a price group

POST
https://partner-api.monta.com
/api/v1/price-groups/{id}/fees

Required scope: price-groups:write
Organization authorization: supported

Add a fee to a price group › path Parameters

id
​integer · int64 · required

Add a fee to a price group › Request Body

type
​string · enum · required

Type of the pricing. minute is used for Minute fee. min is used for the master price.

Enum values:
kwh
min
spot
tariff
starting
charging
idle
minute
Example: kwh
endAtFullyCharged
​boolean · required

Used 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

Example: false
vat
​boolean · required

Used by Spot Price. True means it will add 25% VAT in the price calculations

Example: false
price
​number · required

The price of this Fee or Master price,
Note: the master price cannot be a negative value

description
​string | null

Name of the pricing. It is null when it's the master price

Example: Starting Fee
percentage
​number | null

Used by Spot Price. It will multiply the fallback price by this percentage

Example: 10.2
Default: 100
tariffId
​integer | null · int64

The id of the selected Tariff

Example: 5
tagId
​integer | null · int64

The id of the selected charge pricing tag

Example: 10
applyAfterMinutes
​integer | null · int32

Used by Charging, Minute and Idle Fees. After how many minutes the fee should start being applied.

Example: 30
priceMin
​number | null

Used 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

priceMax
​number | null

Used 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

feePriceMax
​number | null

Used by Idle fee. The maximum the user will be charged for the idle fee

​array | null

Used by spot price. Additional absolute money or percentages values to be added on top of the previous calculations

from
​string | null · date-time

DateTime "from" time to which this pricing should apply from

Example: 2023-03-16T15:37:23Z
to
​string | null · date-time

DateTime "to" time to which this pricing should apply to

Example: 2023-03-16T15:37:23Z
interval
​string · enum

Specifies 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).

Enum values:
hourly
quarterHourly
Example: hourly
​array | null

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

id
​integer · int64 · required

Id of the price group

Example: 522
name
​string · required

Name of the price group

Example: Public Price Group
type
​string · enum · required

Type of the price group

Enum values:
public
member
sponsored
cost
roaming
reimbursement
member_cost
other
Example: public
​object · required

The master price

​array | null · required

Tariffs of the price group

​PriceGroupAppliedTo · required
createdAt
​string · date-time · required

When the price group was created

Example: 2023-03-16T15:37:23Z
teamId
​integer | null · int64

Id of the team for which this price group belongs

Example: 12
default
​boolean
​array | null

Fees of the price group

teamMemberCount
​integer | null · int32

To how many team members the price group has been applied to

chargePointCount
​integer | null · int32

To how many charge points the price group has been applied to

updatedAt
​string | null · date-time

When the price group was updated

Example: 2023-03-16T15:37:23Z

Update a fee in a price group

PUT
https://partner-api.monta.com
/api/v1/price-groups/{id}/fees/{feeId}

Required scope: price-groups:write
Organization authorization: supported

Update a fee in a price group › path Parameters

id
​integer · int64 · required
feeId
​integer · int64 · required

Update a fee in a price group › Request Body

type
​string · enum · required

Type of the pricing. minute is used for Minute fee. min is used for the master price.

Enum values:
kwh
min
spot
tariff
starting
charging
idle
minute
Example: kwh
endAtFullyCharged
​boolean · required

Used 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

Example: false
vat
​boolean · required

Used by Spot Price. True means it will add 25% VAT in the price calculations

Example: false
price
​number · required

The price of this Fee or Master price,
Note: the master price cannot be a negative value

description
​string | null

Name of the pricing. It is null when it's the master price

Example: Starting Fee
percentage
​number | null

Used by Spot Price. It will multiply the fallback price by this percentage

Example: 10.2
Default: 100
tariffId
​integer | null · int64

The id of the selected Tariff

Example: 5
tagId
​integer | null · int64

The id of the selected charge pricing tag

Example: 10
applyAfterMinutes
​integer | null · int32

Used by Charging, Minute and Idle Fees. After how many minutes the fee should start being applied.

Example: 30
priceMin
​number | null

Used 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

priceMax
​number | null

Used 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

feePriceMax
​number | null

Used by Idle fee. The maximum the user will be charged for the idle fee

​array | null

Used by spot price. Additional absolute money or percentages values to be added on top of the previous calculations

from
​string | null · date-time

DateTime "from" time to which this pricing should apply from

Example: 2023-03-16T15:37:23Z
to
​string | null · date-time

DateTime "to" time to which this pricing should apply to

Example: 2023-03-16T15:37:23Z
interval
​string · enum

Specifies 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).

Enum values:
hourly
quarterHourly
Example: hourly
​array | null

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

id
​integer · int64 · required

Id of the price group

Example: 522
name
​string · required

Name of the price group

Example: Public Price Group
type
​string · enum · required

Type of the price group

Enum values:
public
member
sponsored
cost
roaming
reimbursement
member_cost
other
Example: public
​object · required

The master price

​array | null · required

Tariffs of the price group

​PriceGroupAppliedTo · required
createdAt
​string · date-time · required

When the price group was created

Example: 2023-03-16T15:37:23Z
teamId
​integer | null · int64

Id of the team for which this price group belongs

Example: 12
default
​boolean
​array | null

Fees of the price group

teamMemberCount
​integer | null · int32

To how many team members the price group has been applied to

chargePointCount
​integer | null · int32

To how many charge points the price group has been applied to

updatedAt
​string | null · date-time

When the price group was updated

Example: 2023-03-16T15:37:23Z

Delete a fee from a price group

DELETE
https://partner-api.monta.com
/api/v1/price-groups/{id}/fees/{feeId}

Required scope: price-groups:delete
Organization authorization: supported

Delete a fee from a price group › path Parameters

id
​integer · int64 · required
feeId
​integer · int64 · required

Delete a fee from a price group › Responses

Fee successfully deleted

No data returned