Price Groups

Apply price group to charge points, sites or team members

Changed on

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 </br>Organization authorization: supported

put/api/v1/price-groups/{id}/apply

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/price-groups/{id}/apply
  • Auth
    HTTP bearer

Path parameters

idinteger required

Request body

selectedChargePointIdsinteger[] nullable

List of charge point ids

selectedSiteIdsinteger[] nullable

List of site ids

selectedTeamMemberIdsinteger[] nullable

List of team member ids

resetCostboolean nullable

Flag to indicate if costs should be reset

teamIdinteger nullable

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.

Response

Price group successfully applied to the selected entities

idinteger required

Id of the price group

teamIdinteger nullable

Id of the team for which this price group belongs

namestring required

Name of the price group

defaultboolean
type'public' | 'member' | 'sponsored' | 'cost' | 'roaming' | 'reimbursement' | 'member_cost' | 'other' required
teamMemberCountinteger nullable

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

chargePointCountinteger nullable

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

createdAtstring date-time required

When the price group was created

updatedAtstring date-time nullable

When the price group was updated

Example response

{
  "id": 522,
  "teamId": 12,
  "name": "Public Price Group",
  "masterPrice": {
    "id": 1,
    "description": "Starting Fee",
    "master": true,
    "percentage": 10.2,
    "tariffId": 5,
    "updatedAt": "2023-03-16T15:37:23Z",
    "applyAfterMinutes": 30,
    "price": {
      "amount": 12312,
      "currency": {
        "id": 1,
        "master": true,
        "identifier": "DKK",
        "name": "Danish krone",
        "decimals": 2
      },
      "locale": "en"
    },
    "priceMin": {
      "amount": 12312,
      "currency": {
        "id": 1,
        "master": true,
        "identifier": "DKK",
        "name": "Danish krone",
        "decimals": 2
      },
      "locale": "en"
    },
    "priceMax": {
      "amount": 12312,
      "currency": {
        "id": 1,
        "master": true,
        "identifier": "DKK",
        "name": "Danish krone",
        "decimals": 2
      },
      "locale": "en"
    },
    "feePriceMax": {
      "amount": 12312,
      "currency": {
        "id": 1,
        "master": true,
        "identifier": "DKK",
        "name": "Danish krone",
        "decimals": 2
      },
      "locale": "en"
    },
    "additional": [
      {
        "value": {
          "amount": 12312,
          "currency": {
            "id": 1,
            "master": true,
            "identifier": "DKK",
            "name": "Danish krone",
            "decimals": 2
          },
          "locale": "en"
        }
      }
    ],
    "from": "2023-03-16T15:37:23Z",
    "to": "2023-03-16T15:37:23Z",
    "tagId": 109,
    "gracePeriods": [
      {
        "startTime": "09:00:00",
        "endTime": "17:00:00"
      }
    ]
  },
  "tariffs": [
    {
      "id": 1,
      "description": "Starting Fee",
      "master": true,
      "percentage": 10.2,
      "tariffId": 5,
      "updatedAt": "2023-03-16T15:37:23Z",
      "applyAfterMinutes": 30,
      "price": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "priceMin": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "priceMax": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "feePriceMax": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "additional": [
        {
          "value": {
            "amount": 12312,
            "currency": {
              "id": 1,
              "master": true,
              "identifier": "DKK",
              "name": "Danish krone",
              "decimals": 2
            },
            "locale": "en"
          }
        }
      ],
      "from": "2023-03-16T15:37:23Z",
      "to": "2023-03-16T15:37:23Z",
      "tagId": 109,
      "gracePeriods": [
        {
          "startTime": "09:00:00",
          "endTime": "17:00:00"
        }
      ]
    }
  ],
  "fees": [
    {
      "id": 1,
      "description": "Starting Fee",
      "master": true,
      "percentage": 10.2,
      "tariffId": 5,
      "updatedAt": "2023-03-16T15:37:23Z",
      "applyAfterMinutes": 30,
      "price": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "priceMin": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "priceMax": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "feePriceMax": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "additional": [
        {
          "value": {
            "amount": 12312,
            "currency": {
              "id": 1,
              "master": true,
              "identifier": "DKK",
              "name": "Danish krone",
              "decimals": 2
            },
            "locale": "en"
          }
        }
      ],
      "from": "2023-03-16T15:37:23Z",
      "to": "2023-03-16T15:37:23Z",
      "tagId": 109,
      "gracePeriods": [
        {
          "startTime": "09:00:00",
          "endTime": "17:00:00"
        }
      ]
    }
  ],
  "createdAt": "2023-03-16T15:37:23Z",
  "updatedAt": "2023-03-16T15:37:23Z"
}

Changes

    • info

      added the new optional request property

    • info

      added to the ///////// response property allOf list for the response status

    • info

      added to the /////// response property allOf list for the response status

    • info

      added to the /////// response property allOf list for the response status

    • info

      added to the /////// response property allOf list for the response status

    • info

      added to the /////// response property allOf list for the response status

    • info

      added to the //////////// response property allOf list for the response status

    • info

      added to the ////////// response property allOf list for the response status

    • info

      added to the ////////// response property allOf list for the response status

    • info

      added to the ////////// response property allOf list for the response status

    • info

      added to the ////////// response property allOf list for the response status

    • info

      added to the ///////// response property allOf list for the response status

    • info

      added to the /////// response property allOf list for the response status

    • info

      added to the /////// response property allOf list for the response status

    • info

      added to the /////// response property allOf list for the response status

    • info

      added to the /////// response property allOf list for the response status

    • info

      removed from the ///////// response property allOf list for the response status

    • info

      removed from the /////// response property allOf list for the response status

    • info

      removed from the /////// response property allOf list for the response status

    • info

      removed from the /////// response property allOf list for the response status

    • info

      removed from the /////// response property allOf list for the response status

    • info

      removed from the //////////// response property allOf list for the response status

    • info

      removed from the ////////// response property allOf list for the response status

    • info

      removed from the ////////// response property allOf list for the response status

    • info

      removed from the ////////// response property allOf list for the response status

    • info

      removed from the ////////// response property allOf list for the response status

    • info

      removed from the ///////// response property allOf list for the response status

    • info

      removed from the /////// response property allOf list for the response status

    • info

      removed from the /////// response property allOf list for the response status

    • info

      removed from the /////// response property allOf list for the response status

    • info

      removed from the /////// response property allOf list for the response status