Sign in

v1

latestOpenAPI 3.0.12026-07-243686491.1 MB
Tariff

Retrieve public grid tariffs with period schedules.

Returns public DSO/TSO grid tariffs with their period groups and pricing schedules. Required scope: tariffs:read</br></br>Availability: This endpoint is not available by default. It must be explicitly enabled for your operator account upon request. Please contact your Monta Business Partner to request access to this feature.

get/api/v1/tariffs/grid

Query parameters

countryIdinteger

Filter by country (e.g., 194 for Denmark)

integer
OR
integer

Filter period groups by year (e.g., 2026)

namestring

Filter by tariff name

Response

List of public grid tariffs

idinteger

Id of the tariff

externalIdstring required

External id of the tariff

namestring required

Name of the tariff

descriptionstring required

Description of the tariff

countryIdinteger

Country Id of the tariff

countryAreaIdinteger nullable

Country area Id of the tariff

currencyIdinteger

Currency Id of the tariff

pricesWithVatboolean

Indicates if VAT is already in the price of the tariff

zipCodesstring[] required

Zip codes covered by this tariff

tariffType'WEEKLY' | 'DYNAMIC' required
activeboolean

Indicates if the tariff is active

timeZonestring required

Time zone of the tariff

areastring required

Area of the tariff

customerType'A_ZERO' | 'A_HIGH' | 'A_LOW' | 'B_HIGH' | 'B_LOW' | 'C_CUSTOMER'
createdAtstring date-time required

Creation date of the tariff

updatedAtstring date-time nullable

Last update date of the tariff

Example response

[
  {
    "id": 1,
    "externalId": "3143",
    "name": "Cerius",
    "description": "DSO tariff for Cerius grid area",
    "countryId": 194,
    "countryAreaId": 1,
    "currencyId": 1,
    "zipCodes": [
      "5610",
      "5960"
    ],
    "active": true,
    "timeZone": "Europe/Copenhagen",
    "area": "Jylland",
    "createdAt": "2023-03-23T14:54:56Z",
    "updatedAt": "2023-03-23T16:54:56Z",
    "periodGroups": [
      {
        "id": 1,
        "activeFrom": "2026-01-01",
        "activeTo": "2026-12-31",
        "description": "2026 pricing schedule",
        "recurringPeriods": [
          {
            "id": 1,
            "endHour": 6,
            "price": 0.25,
            "rateName": "Peak"
          }
        ]
      }
    ]
  }
]