Prices Forecast

Retrieve prices forecast.

GET

https://partner-api.monta.com

/api/v1/prices/forecast

Prices can be forecasted for a charge point and optionally a price group, when priceGroupId is not provided the charge point price group will be used.
Note: This endpoint is in BETA phase and is subject to changes in a near future release

Required scope: prices-forecast:read
Organization authorization: supported

Retrieve prices forecast. › query Parameters

chargePointId

integer · int64

Filter to retrieve prices forecast for the specified chargePointId

Example: 13

priceGroupId

integer | null · int64

Filter to retrieve prices forecast for the specified priceGroupId

Example: 130

teamMemberId

integer | null · int64

Filter to retrieve prices forecast for the specified teamMemberId

Example: 13

Retrieve prices forecast. › Responses

Prices Forecast for the given filter

PricesForecast

object · required

The operator to which this charge point and price group belongs to

object · required

The currency applicable for this forecast

object · required

The price group applicable for this forecast

PricesForecastEntry[] · required

The compilation of entries composing this prices forecast

GET/api/v1/prices/forecast

curl https://partner-api.monta.com/api/v1/prices/forecast \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "currency": {
    "identifier": "dkk",
    "name": "Danish krone",
    "decimals": 2
  },
  "priceGroup": {
    "id": 522,
    "teamId": 12,
    "name": "Public Price Group",
    "default": true,
    "type": "public",
    "masterPrice": {
      "id": 1,
      "description": "Starting Fee",
      "type": "min",
      "master": true,
      "dynamicPricing": false,
      "endAtFullyCharged": false,
      "vat": false,
      "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": [
        {
          "type": "percentage",
          "value": {
            "amount": 12312,
            "currency": {
              "id": 1,
              "master": true,
              "identifier": "DKK",
              "name": "Danish krone",
              "decimals": 2
            },
            "locale": "en"
          },
          "title": "title"
        }
      ],
      "from": "2023-03-16T15:37:23Z",
      "to": "2023-03-16T15:37:23Z",
      "tagId": 109,
      "interval": "hourly",
      "gracePeriods": [
        {
          "startTime": "09:00:00",
          "endTime": "17:00:00"
        }
      ]
    },
    "tariffs": [
      {
        "id": 1,
        "description": "Starting Fee",
        "type": "min",
        "master": true,
        "dynamicPricing": false,
        "endAtFullyCharged": false,
        "vat": false,
        "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": [
          {
            "type": "percentage",
            "value": {
              "amount": 12312,
              "currency": {
                "id": 1,
                "master": true,
                "identifier": "DKK",
                "name": "Danish krone",
                "decimals": 2
              },
              "locale": "en"
            },
            "title": "title"
          }
        ],
        "from": "2023-03-16T15:37:23Z",
        "to": "2023-03-16T15:37:23Z",
        "tagId": 109,
        "interval": "hourly",
        "gracePeriods": [
          {
            "startTime": "09:00:00",
            "endTime": "17:00:00"
          }
        ]
      }
    ],
    "fees": [
      {
        "id": 1,
        "description": "Starting Fee",
        "type": "min",
        "master": true,
        "dynamicPricing": false,
        "endAtFullyCharged": false,
        "vat": false,
        "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": [
          {
            "type": "percentage",
            "value": {
              "amount": 12312,
              "currency": {
                "id": 1,
                "master": true,
                "identifier": "DKK",
                "name": "Danish krone",
                "decimals": 2
              },
              "locale": "en"
            },
            "title": "title"
          }
        ],
        "from": "2023-03-16T15:37:23Z",
        "to": "2023-03-16T15:37:23Z",
        "tagId": 109,
        "interval": "hourly",
        "gracePeriods": [
          {
            "startTime": "09:00:00",
            "endTime": "17:00:00"
          }
        ]
      }
    ],
    "teamMemberCount": 0,
    "chargePointCount": 0,
    "appliedTo": {
      "chargePoints": [
        0
      ],
      "sites": [
        0
      ],
      "teamMembers": [
        0
      ]
    },
    "createdAt": "2023-03-16T15:37:23Z",
    "updatedAt": "2023-03-16T15:37:23Z"
  },
  "forecasts": [
    {
      "time": "2023-11-29T18:00:00Z",
      "pricePerKwh": 5978,
      "name": "0.60 DKK/kWh"
    }
  ]
}

json

application/json

Price Groups Tags Promotion Codes