Sites

Retrieve your (charge) sites

GET

https://partner-api.monta.com

/api/v1/sites

Required scope: charge-points:read
Organization authorization: supported

Retrieve your (charge) sites › 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

teamId

integer | null · int64

Allows to filter by a team id.

Example: 19

partnerExternalId

string | null

Filter by partnerExternalId, to filter only resources without partnerExternalId use partnerExternalId=""

Example: 1

sortByLocation

string | null · pattern: ^(-?\d*\.\d+|\d+\.\d…

lat,long coordinates. If supplied, the Charge Points will be sorted in nearest first order relativeto this point. (Format: 55.7096,12.5856, -8.050000, -34.900002)

Example: 55.7096,12.5856

operatorId

integer | null · int64

Allows to filter sites by operatorId.
*Note:*The operatorId must be in the consumer’s operatorIds or, if empty, belong to the organization’s sub-operators.

Example: 1

includePublic

boolean

Includes public sites from other operators in the response
Note: Only supported from Version 2024-07-01

Example: false

Default: false

includeDeleted

boolean

Includes deleted resources in the response

Example: true

Default: false

Retrieve your (charge) sites › Responses

List of sites that match the criteria

OffsetBasedResponse_53

Site_1[] · required

MontaPage.Meta · required

GET/api/v1/sites

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

Example Responses

{
  "data": [
    {
      "id": 1,
      "teamId": 13,
      "partnerExternalId": "ACME-12345",
      "partnerCustomPayload": {
        "internalId": "ACME-12345",
        "department": "Fleet"
      },
      "name": "Monta CPH HQ",
      "operator": {
        "id": 14,
        "name": "Monta",
        "identifier": "monta",
        "partnerId": 1,
        "vatNumber": "FOO-123-ABC"
      },
      "createdAt": "2022-05-12T15:56:45.99Z",
      "updatedAt": "2022-05-12T16:56:45.99Z",
      "deletedAt": "2022-05-12T16:56:45.99Z",
      "chargePointCount": 42,
      "activeChargePointCount": 33,
      "availableChargePointCount": 4,
      "maxKW": 150,
      "maxKw": 150,
      "type": "ac",
      "visibility": "public",
      "showOnMap": true,
      "driverSupportVisibility": "inherit",
      "note": "In order to access this site enter 0000 as code at the gate.",
      "location": {
        "coordinates": {
          "latitude": 55.6760968,
          "longitude": 12.5683371
        },
        "addressLabel": "Strandboulevarden 122, 5. sal, 2100 København, Denmark",
        "address": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "countrySubdivisionCode": "US-GA",
          "country": "Denmark",
          "countryAreaId": 1
        }
      },
      "connectors": [
        {
          "id": 1,
          "identifier": "ccs",
          "name": "CCS"
        }
      ],
      "metadata": {
        "atm": true,
        "digitalChargePriceDisplay": false,
        "driverLounge": true,
        "fuelStation": false,
        "parkingArea": true,
        "powerSupply": true,
        "shower": false,
        "vendingMachine": true,
        "washingMachine": false,
        "wifi": true,
        "toilets": 2,
        "cafe": true,
        "foodDelivery": false,
        "hotel": true,
        "mall": false,
        "museum": true,
        "park": true,
        "outdoorGym": false,
        "recreationArea": true,
        "restaurant": true,
        "supermarket": false,
        "airport": false,
        "bikeSharing": true,
        "busStop": true,
        "carpoolParking": false,
        "metroStation": true,
        "taxiStand": false,
        "tramStop": true,
        "secureTruckParking": false,
        "truckDealership": true,
        "truckParking": true,
        "truckRepair": false,
        "truckWash": true,
        "accessControlledArea": true,
        "cameraSurveillance": false,
        "entryGate": true,
        "exitGate": false,
        "floodLighting": true,
        "guard": false,
        "licensePlateRecognition": true,
        "pedestrianTurnstiles": false,
        "perimeterFence": true,
        "energyMix": {
          "isGreenEnergy": true,
          "energySources": [
            {
              "source": "SOLAR",
              "percentage": 40
            }
          ],
          "environmentImpact": [
            {
              "category": "CO2",
              "amount": 12.5
            }
          ],
          "supplierName": "Green Energy Supplier",
          "energyProductName": "EcoPower 2025"
        },
        "pictures": [
          "https://example.com/picture1.jpg",
          "https://example.com/picture2.jpg"
        ],
        "siteDeveloper": {
          "name": "John Doe",
          "email": "john.doe@example.com",
          "companyRegistrationNumber": "12345678"
        },
        "cafeAddress": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "country": "Denmark",
          "countryAreaId": 1
        },
        "foodDeliveryAddress": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "country": "Denmark",
          "countryAreaId": 1
        },
        "hotelAddress": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "country": "Denmark",
          "countryAreaId": 1
        },
        "mallAddress": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "country": "Denmark",
          "countryAreaId": 1
        },
        "museumAddress": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "country": "Denmark",
          "countryAreaId": 1
        },
        "parkAddress": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "country": "Denmark",
          "countryAreaId": 1
        },
        "outdoorGymAddress": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "country": "Denmark",
          "countryAreaId": 1
        },
        "recreationAreaAddress": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "country": "Denmark",
          "countryAreaId": 1
        },
        "restaurantAddress": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "country": "Denmark",
          "countryAreaId": 1
        },
        "supermarketAddress": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "country": "Denmark",
          "countryAreaId": 1
        },
        "parkingType": "onDriveway",
        "roofed": true,
        "lighting": true,
        "openingDate": "2023-01-01",
        "openingHours": {
          "openingTimes": {
            "twentyFourSeven": false,
            "regularHours": {
              "weekday": 1,
              "periodBegin": "08:00",
              "periodEnd": "17:00"
            },
            "exceptionalOpenings": {
              "periodBegin": "08:00",
              "periodEnd": "17:00"
            },
            "exceptionalClosings": {
              "periodBegin": "08:00",
              "periodEnd": "17:00"
            }
          },
          "chargingWhenClosed": true
        },
        "totalParkingSpaces": 100,
        "totalAccessibleSpace": 10,
        "truckOnly": false,
        "trailerParking": true,
        "facilities": "Road",
        "venueWithAccessibility": true
      }
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Create a (charge) site

POST

https://partner-api.monta.com

/api/v1/sites

Required scope: charge-points:write
Organization authorization: supported

Create a (charge) site › Request Body

CreateSite

teamId

integer · int64 · required

Id of the team that the site belongs to

Example: 13

name

string · minLength: 1 · required

Name of the site

Example: Monta CPH Site

object · required

Address of the site. countryId is always required. address1, city, and zipCode must either all be provided (geocoding will resolve coordinates) or all be left null — in which case latitude and longitude must be supplied instead. Partial addresses are rejected.

visibility

string · enum · required

Visibility type of the site. Controls who can charge at the site: public means any Monta user can charge here, private restricts charging to team members / access-token holders. This field does NOT control whether the site appears on the consumer map — use showOnMap for that.

Enum values:

private

public

Example: private

latitude

number | null · min: -90 · max: 90

Latitude coordinate for the site location. Required when the address (address1/city/zipCode) is omitted. When provided along with longitude, overrides geocoding from address.

Example: 55.6761

longitude

number | null · min: -180 · max: 180

Longitude coordinate for the site location. Required when the address (address1/city/zipCode) is omitted. When provided along with latitude, overrides geocoding from address.

Example: 12.5683

showOnMap

boolean | null

Whether this site should be visible on the consumer map. If omitted, the site will be visible on the map by default. This is independent of visibility — a private site can still be shown on the map, and a public site can be hidden.

Example: true

driverSupportVisibility

string · enum

Whether Monta's AI Driver Support may reach drivers at this site. Defaults to inherit when omitted.
- inherit — follow the site's visibility: a public site is reachable, a private site is not.
- public — always reachable, even when the site's visibility is private.
- off — never reachable, even when the site is public.

Enum values:

inherit

public

off

Example: public

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys. The payload is limited to 1000 characters.

Example: {"internalId":"ACME-12345","department":"Fleet"}

object

Metadata for the site including amenities, energy mix, opening hours, site developer, and pictures.

note

string | null

A free-text note for this site, visible in the app.

Example: Main entrance on north side

Create a (charge) site › Responses

Site created

Site_1

name

string · required

Name of the site

Example: Monta CPH HQ

createdAt

string · date-time · required

Creation date of this charging site

Example: 2022-05-12T15:56:45.99Z

updatedAt

string · date-time · required

Date this charging site was last updated

Example: 2022-05-12T16:56:45.99Z

visibility

string · enum · required

Indicates if this site is public or private. Controls who can charge at the site; independent of showOnMap.

Enum values:

private

public

Example: public

driverSupportVisibility

string · enum · required

Whether Monta's AI Driver Support may reach drivers at this site.
- inherit — follow the site's visibility: a public site is reachable, a private site is not.
- public — always reachable, even when the site's visibility is private.
- off — never reachable, even when the site is public.

Enum values:

inherit

public

off

Example: inherit

object · required

Location information for this site

ChargePointConnector[] · required

List of supported connector types at this site (e.g. type-2, ccs, ...)

id

integer · int64

Id of the site

Example: 1

teamId

integer | null · int64

Id of the team that has access to the site

Example: 13

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

object

Operator of this charging site

deletedAt

string | null · date-time

Date this charging site was deleted

Example: 2022-05-12T16:56:45.99Z

chargePointCount

integer · int64

Number of charge points at this site

Example: 42

activeChargePointCount

integer · int64

Number of active charge points at this site

Example: 33

availableChargePointCount

integer · int64

Number of available charge points at this site

Example: 4

maxKw

number | null · double

Max KW available at this site.

Example: 150

type

string | null · enum

Type of charge points at this site (AC / DC)

Enum values:

Example: ac

showOnMap

boolean | null

Whether this site is visible on the consumer map. Independent of visibility: a public site can still be hidden, and a private site can still be shown.

Example: true

note

string | null

A note you have entered for this site, e.g. via our Portal.

Example: In order to access this site enter 0000 as code at the gate.

object

Additional information for this site, e.g. totalParkingSpaces.

POST/api/v1/sites

curl https://partner-api.monta.com/api/v1/sites \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "operatorId": 1,
  "teamId": 13,
  "name": "Monta CPH Site",
  "address": {
    "address1": "Strandboulevarden 122",
    "address2": "København",
    "address3": "5. sal",
    "city": "Berlin",
    "zipCode": "10011",
    "countryId": 194,
    "countryAreaId": 1
  },
  "latitude": 55.6761,
  "longitude": 12.5683,
  "visibility": "private",
  "showOnMap": true,
  "driverSupportVisibility": "public",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "metadata": {
    "amenities": [
      {
        "attribute": "wifi",
        "value": true
      }
    ],
    "energyMix": {
      "isGreenEnergy": true,
      "energySources": [
        {
          "source": "SOLAR",
          "percentage": 40
        }
      ],
      "environImpact": [
        {
          "category": "CARBON_DIOXIDE",
          "amount": 12.5
        }
      ],
      "supplierName": "Green Energy Supplier",
      "energyProductName": "EcoPower 2025"
    },
    "openingHours": {
      "openingTimes": {
        "twentyFourSeven": false,
        "regularHours": [
          {
            "weekday": 1,
            "periodBegin": "08:00",
            "periodEnd": "17:00"
          }
        ],
        "exceptionalOpenings": [
          {
            "periodBegin": "2025-06-01T08:00:00Z",
            "periodEnd": "2025-06-01T18:00:00Z"
          }
        ],
        "exceptionalClosings": [
          {
            "periodBegin": "2025-06-01T08:00:00Z",
            "periodEnd": "2025-06-01T18:00:00Z"
          }
        ]
      },
      "chargingWhenClosed": true
    },
    "siteDeveloper": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "companyRegistrationNumber": "12345678"
    },
    "pictures": [
      "string"
    ]
  },
  "note": "Main entrance on north side"
}'

Example Request Body

{
  "operatorId": 1,
  "teamId": 13,
  "name": "Monta CPH Site",
  "address": {
    "address1": "Strandboulevarden 122",
    "address2": "København",
    "address3": "5. sal",
    "city": "Berlin",
    "zipCode": "10011",
    "countryId": 194,
    "countryAreaId": 1
  },
  "latitude": 55.6761,
  "longitude": 12.5683,
  "visibility": "private",
  "showOnMap": true,
  "driverSupportVisibility": "public",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "metadata": {
    "amenities": [
      {
        "attribute": "wifi",
        "value": true
      }
    ],
    "energyMix": {
      "isGreenEnergy": true,
      "energySources": [
        {
          "source": "SOLAR",
          "percentage": 40
        }
      ],
      "environImpact": [
        {
          "category": "CARBON_DIOXIDE",
          "amount": 12.5
        }
      ],
      "supplierName": "Green Energy Supplier",
      "energyProductName": "EcoPower 2025"
    },
    "openingHours": {
      "openingTimes": {
        "twentyFourSeven": false,
        "regularHours": [
          {
            "weekday": 1,
            "periodBegin": "08:00",
            "periodEnd": "17:00"
          }
        ],
        "exceptionalOpenings": [
          {
            "periodBegin": "2025-06-01T08:00:00Z",
            "periodEnd": "2025-06-01T18:00:00Z"
          }
        ],
        "exceptionalClosings": [
          {
            "periodBegin": "2025-06-01T08:00:00Z",
            "periodEnd": "2025-06-01T18:00:00Z"
          }
        ]
      },
      "chargingWhenClosed": true
    },
    "siteDeveloper": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "companyRegistrationNumber": "12345678"
    },
    "pictures": [
      "string"
    ]
  },
  "note": "Main entrance on north side"
}

json

Example Responses

{
  "id": 1,
  "teamId": 13,
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "name": "Monta CPH HQ",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "createdAt": "2022-05-12T15:56:45.99Z",
  "updatedAt": "2022-05-12T16:56:45.99Z",
  "deletedAt": "2022-05-12T16:56:45.99Z",
  "chargePointCount": 42,
  "activeChargePointCount": 33,
  "availableChargePointCount": 4,
  "maxKW": 150,
  "maxKw": 150,
  "type": "ac",
  "visibility": "public",
  "showOnMap": true,
  "driverSupportVisibility": "inherit",
  "note": "In order to access this site enter 0000 as code at the gate.",
  "location": {
    "coordinates": {
      "latitude": 55.6760968,
      "longitude": 12.5683371
    },
    "addressLabel": "Strandboulevarden 122, 5. sal, 2100 København, Denmark",
    "address": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "countrySubdivisionCode": "US-GA",
      "country": "Denmark",
      "countryAreaId": 1
    }
  },
  "connectors": [
    {
      "id": 1,
      "identifier": "ccs",
      "name": "CCS"
    }
  ],
  "metadata": {
    "atm": true,
    "digitalChargePriceDisplay": false,
    "driverLounge": true,
    "fuelStation": false,
    "parkingArea": true,
    "powerSupply": true,
    "shower": false,
    "vendingMachine": true,
    "washingMachine": false,
    "wifi": true,
    "toilets": 2,
    "cafe": true,
    "foodDelivery": false,
    "hotel": true,
    "mall": false,
    "museum": true,
    "park": true,
    "outdoorGym": false,
    "recreationArea": true,
    "restaurant": true,
    "supermarket": false,
    "airport": false,
    "bikeSharing": true,
    "busStop": true,
    "carpoolParking": false,
    "metroStation": true,
    "taxiStand": false,
    "tramStop": true,
    "secureTruckParking": false,
    "truckDealership": true,
    "truckParking": true,
    "truckRepair": false,
    "truckWash": true,
    "accessControlledArea": true,
    "cameraSurveillance": false,
    "entryGate": true,
    "exitGate": false,
    "floodLighting": true,
    "guard": false,
    "licensePlateRecognition": true,
    "pedestrianTurnstiles": false,
    "perimeterFence": true,
    "energyMix": {
      "isGreenEnergy": true,
      "energySources": [
        {
          "source": "SOLAR",
          "percentage": 40
        }
      ],
      "environmentImpact": [
        {
          "category": "CO2",
          "amount": 12.5
        }
      ],
      "supplierName": "Green Energy Supplier",
      "energyProductName": "EcoPower 2025"
    },
    "pictures": [
      "https://example.com/picture1.jpg",
      "https://example.com/picture2.jpg"
    ],
    "siteDeveloper": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "companyRegistrationNumber": "12345678"
    },
    "cafeAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "foodDeliveryAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "hotelAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "mallAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "museumAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "parkAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "outdoorGymAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "recreationAreaAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "restaurantAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "supermarketAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "parkingType": "onDriveway",
    "roofed": true,
    "lighting": true,
    "openingDate": "2023-01-01",
    "openingHours": {
      "openingTimes": {
        "twentyFourSeven": false,
        "regularHours": {
          "weekday": 1,
          "periodBegin": "08:00",
          "periodEnd": "17:00"
        },
        "exceptionalOpenings": {
          "periodBegin": "08:00",
          "periodEnd": "17:00"
        },
        "exceptionalClosings": {
          "periodBegin": "08:00",
          "periodEnd": "17:00"
        }
      },
      "chargingWhenClosed": true
    },
    "totalParkingSpaces": 100,
    "totalAccessibleSpace": 10,
    "truckOnly": false,
    "trailerParking": true,
    "facilities": "Road",
    "venueWithAccessibility": true
  }
}

json

application/json

Retrieve a single (charge) site

GET

https://partner-api.monta.com

/api/v1/sites/{siteId}

Required scope: charge-points:read
Organization authorization: supported

Retrieve a single (charge) site › path Parameters

siteId

integer · int64 · required

Retrieve a single (charge) site › Responses

Site with provided id

Site_1

name

string · required

Name of the site

Example: Monta CPH HQ

createdAt

string · date-time · required

Creation date of this charging site

Example: 2022-05-12T15:56:45.99Z

updatedAt

string · date-time · required

Date this charging site was last updated

Example: 2022-05-12T16:56:45.99Z

visibility

string · enum · required

Indicates if this site is public or private. Controls who can charge at the site; independent of showOnMap.

Enum values:

private

public

Example: public

driverSupportVisibility

string · enum · required

Enum values:

inherit

public

off

Example: inherit

object · required

Location information for this site

ChargePointConnector[] · required

List of supported connector types at this site (e.g. type-2, ccs, ...)

id

integer · int64

Id of the site

Example: 1

teamId

integer | null · int64

Id of the team that has access to the site

Example: 13

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

object

Operator of this charging site

deletedAt

string | null · date-time

Date this charging site was deleted

Example: 2022-05-12T16:56:45.99Z

chargePointCount

integer · int64

Number of charge points at this site

Example: 42

activeChargePointCount

integer · int64

Number of active charge points at this site

Example: 33

availableChargePointCount

integer · int64

Number of available charge points at this site

Example: 4

maxKw

number | null · double

Max KW available at this site.

Example: 150

type

string | null · enum

Type of charge points at this site (AC / DC)

Enum values:

Example: ac

showOnMap

boolean | null

Whether this site is visible on the consumer map. Independent of visibility: a public site can still be hidden, and a private site can still be shown.

Example: true

note

string | null

A note you have entered for this site, e.g. via our Portal.

Example: In order to access this site enter 0000 as code at the gate.

object

Additional information for this site, e.g. totalParkingSpaces.

GET/api/v1/sites/{siteId}

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

Example Responses

{
  "id": 1,
  "teamId": 13,
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "name": "Monta CPH HQ",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "createdAt": "2022-05-12T15:56:45.99Z",
  "updatedAt": "2022-05-12T16:56:45.99Z",
  "deletedAt": "2022-05-12T16:56:45.99Z",
  "chargePointCount": 42,
  "activeChargePointCount": 33,
  "availableChargePointCount": 4,
  "maxKW": 150,
  "maxKw": 150,
  "type": "ac",
  "visibility": "public",
  "showOnMap": true,
  "driverSupportVisibility": "inherit",
  "note": "In order to access this site enter 0000 as code at the gate.",
  "location": {
    "coordinates": {
      "latitude": 55.6760968,
      "longitude": 12.5683371
    },
    "addressLabel": "Strandboulevarden 122, 5. sal, 2100 København, Denmark",
    "address": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "countrySubdivisionCode": "US-GA",
      "country": "Denmark",
      "countryAreaId": 1
    }
  },
  "connectors": [
    {
      "id": 1,
      "identifier": "ccs",
      "name": "CCS"
    }
  ],
  "metadata": {
    "atm": true,
    "digitalChargePriceDisplay": false,
    "driverLounge": true,
    "fuelStation": false,
    "parkingArea": true,
    "powerSupply": true,
    "shower": false,
    "vendingMachine": true,
    "washingMachine": false,
    "wifi": true,
    "toilets": 2,
    "cafe": true,
    "foodDelivery": false,
    "hotel": true,
    "mall": false,
    "museum": true,
    "park": true,
    "outdoorGym": false,
    "recreationArea": true,
    "restaurant": true,
    "supermarket": false,
    "airport": false,
    "bikeSharing": true,
    "busStop": true,
    "carpoolParking": false,
    "metroStation": true,
    "taxiStand": false,
    "tramStop": true,
    "secureTruckParking": false,
    "truckDealership": true,
    "truckParking": true,
    "truckRepair": false,
    "truckWash": true,
    "accessControlledArea": true,
    "cameraSurveillance": false,
    "entryGate": true,
    "exitGate": false,
    "floodLighting": true,
    "guard": false,
    "licensePlateRecognition": true,
    "pedestrianTurnstiles": false,
    "perimeterFence": true,
    "energyMix": {
      "isGreenEnergy": true,
      "energySources": [
        {
          "source": "SOLAR",
          "percentage": 40
        }
      ],
      "environmentImpact": [
        {
          "category": "CO2",
          "amount": 12.5
        }
      ],
      "supplierName": "Green Energy Supplier",
      "energyProductName": "EcoPower 2025"
    },
    "pictures": [
      "https://example.com/picture1.jpg",
      "https://example.com/picture2.jpg"
    ],
    "siteDeveloper": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "companyRegistrationNumber": "12345678"
    },
    "cafeAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "foodDeliveryAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "hotelAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "mallAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "museumAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "parkAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "outdoorGymAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "recreationAreaAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "restaurantAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "supermarketAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "parkingType": "onDriveway",
    "roofed": true,
    "lighting": true,
    "openingDate": "2023-01-01",
    "openingHours": {
      "openingTimes": {
        "twentyFourSeven": false,
        "regularHours": {
          "weekday": 1,
          "periodBegin": "08:00",
          "periodEnd": "17:00"
        },
        "exceptionalOpenings": {
          "periodBegin": "08:00",
          "periodEnd": "17:00"
        },
        "exceptionalClosings": {
          "periodBegin": "08:00",
          "periodEnd": "17:00"
        }
      },
      "chargingWhenClosed": true
    },
    "totalParkingSpaces": 100,
    "totalAccessibleSpace": 10,
    "truckOnly": false,
    "trailerParking": true,
    "facilities": "Road",
    "venueWithAccessibility": true
  }
}

json

application/json

Patch an existing (charge) site

PATCH

https://partner-api.monta.com

/api/v1/sites/{siteId}

Required scope: charge-points:write
Organization authorization: supported

Patch an existing (charge) site › path Parameters

siteId

integer · int64 · required

Patch an existing (charge) site › Request Body

PatchSite

name

string | null

Name of the site

Example: Monta CPH Site

object

Address of the site. Only countryId is mandatory. Address1, city, and zipCode must be provided together or all left null.

latitude

number | null · min: -90 · max: 90

Latitude coordinate for the site location. When provided along with longitude, overrides geocoding from address.

Example: 55.6761

longitude

number | null · min: -180 · max: 180

Longitude coordinate for the site location. When provided along with latitude, overrides geocoding from address.

Example: 12.5683

visibility

string · enum

Enum values:

private

public

Example: private

showOnMap

boolean | null

Whether this site should be visible on the consumer map. This is independent of visibility — a private site can still be shown on the map, and a public site can be hidden.

Example: true

driverSupportVisibility

string · enum

Whether Monta's AI Driver Support may reach drivers at this site. Omit to leave the current value untouched.
- inherit — follow the site's visibility: a public site is reachable, a private site is not.
- public — always reachable, even when the site's visibility is private.
- off — never reachable, even when the site is public.

Enum values:

inherit

public

off

Example: public

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys. The payload is limited to 1000 characters.

Example: {"internalId":"ACME-12345","department":"Fleet"}

object

Metadata for the site including amenities, energy mix, opening hours, site developer, and pictures.

note

string | null

A free-text note for this site, visible in the app.

Example: Main entrance on north side

Patch an existing (charge) site › Responses

Site updated

Site_1

name

string · required

Name of the site

Example: Monta CPH HQ

createdAt

string · date-time · required

Creation date of this charging site

Example: 2022-05-12T15:56:45.99Z

updatedAt

string · date-time · required

Date this charging site was last updated

Example: 2022-05-12T16:56:45.99Z

visibility

string · enum · required

Indicates if this site is public or private. Controls who can charge at the site; independent of showOnMap.

Enum values:

private

public

Example: public

driverSupportVisibility

string · enum · required

Enum values:

inherit

public

off

Example: inherit

object · required

Location information for this site

ChargePointConnector[] · required

List of supported connector types at this site (e.g. type-2, ccs, ...)

id

integer · int64

Id of the site

Example: 1

teamId

integer | null · int64

Id of the team that has access to the site

Example: 13

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

object

Operator of this charging site

deletedAt

string | null · date-time

Date this charging site was deleted

Example: 2022-05-12T16:56:45.99Z

chargePointCount

integer · int64

Number of charge points at this site

Example: 42

activeChargePointCount

integer · int64

Number of active charge points at this site

Example: 33

availableChargePointCount

integer · int64

Number of available charge points at this site

Example: 4

maxKw

number | null · double

Max KW available at this site.

Example: 150

type

string | null · enum

Type of charge points at this site (AC / DC)

Enum values:

Example: ac

showOnMap

boolean | null

Whether this site is visible on the consumer map. Independent of visibility: a public site can still be hidden, and a private site can still be shown.

Example: true

note

string | null

A note you have entered for this site, e.g. via our Portal.

Example: In order to access this site enter 0000 as code at the gate.

object

Additional information for this site, e.g. totalParkingSpaces.

PATCH/api/v1/sites/{siteId}

curl https://partner-api.monta.com/api/v1/sites/:siteId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "Monta CPH Site",
  "address": {
    "address1": "Strandboulevarden 122",
    "address2": "København",
    "address3": "5. sal",
    "city": "Berlin",
    "zipCode": "10011",
    "countryId": 194,
    "countryAreaId": 1
  },
  "latitude": 55.6761,
  "longitude": 12.5683,
  "visibility": "private",
  "showOnMap": true,
  "driverSupportVisibility": "public",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "metadata": {
    "amenities": [
      {
        "attribute": "wifi",
        "value": true
      }
    ],
    "energyMix": {
      "isGreenEnergy": true,
      "energySources": [
        {
          "source": "SOLAR",
          "percentage": 40
        }
      ],
      "environImpact": [
        {
          "category": "CARBON_DIOXIDE",
          "amount": 12.5
        }
      ],
      "supplierName": "Green Energy Supplier",
      "energyProductName": "EcoPower 2025"
    },
    "openingHours": {
      "openingTimes": {
        "twentyFourSeven": false,
        "regularHours": [
          {
            "weekday": 1,
            "periodBegin": "08:00",
            "periodEnd": "17:00"
          }
        ],
        "exceptionalOpenings": [
          {
            "periodBegin": "2025-06-01T08:00:00Z",
            "periodEnd": "2025-06-01T18:00:00Z"
          }
        ],
        "exceptionalClosings": [
          {
            "periodBegin": "2025-06-01T08:00:00Z",
            "periodEnd": "2025-06-01T18:00:00Z"
          }
        ]
      },
      "chargingWhenClosed": true
    },
    "siteDeveloper": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "companyRegistrationNumber": "12345678"
    },
    "pictures": [
      "string"
    ]
  },
  "note": "Main entrance on north side"
}'

Example Request Body

{
  "name": "Monta CPH Site",
  "address": {
    "address1": "Strandboulevarden 122",
    "address2": "København",
    "address3": "5. sal",
    "city": "Berlin",
    "zipCode": "10011",
    "countryId": 194,
    "countryAreaId": 1
  },
  "latitude": 55.6761,
  "longitude": 12.5683,
  "visibility": "private",
  "showOnMap": true,
  "driverSupportVisibility": "public",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "metadata": {
    "amenities": [
      {
        "attribute": "wifi",
        "value": true
      }
    ],
    "energyMix": {
      "isGreenEnergy": true,
      "energySources": [
        {
          "source": "SOLAR",
          "percentage": 40
        }
      ],
      "environImpact": [
        {
          "category": "CARBON_DIOXIDE",
          "amount": 12.5
        }
      ],
      "supplierName": "Green Energy Supplier",
      "energyProductName": "EcoPower 2025"
    },
    "openingHours": {
      "openingTimes": {
        "twentyFourSeven": false,
        "regularHours": [
          {
            "weekday": 1,
            "periodBegin": "08:00",
            "periodEnd": "17:00"
          }
        ],
        "exceptionalOpenings": [
          {
            "periodBegin": "2025-06-01T08:00:00Z",
            "periodEnd": "2025-06-01T18:00:00Z"
          }
        ],
        "exceptionalClosings": [
          {
            "periodBegin": "2025-06-01T08:00:00Z",
            "periodEnd": "2025-06-01T18:00:00Z"
          }
        ]
      },
      "chargingWhenClosed": true
    },
    "siteDeveloper": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "companyRegistrationNumber": "12345678"
    },
    "pictures": [
      "string"
    ]
  },
  "note": "Main entrance on north side"
}

json

Example Responses

{
  "id": 1,
  "teamId": 13,
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "name": "Monta CPH HQ",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "createdAt": "2022-05-12T15:56:45.99Z",
  "updatedAt": "2022-05-12T16:56:45.99Z",
  "deletedAt": "2022-05-12T16:56:45.99Z",
  "chargePointCount": 42,
  "activeChargePointCount": 33,
  "availableChargePointCount": 4,
  "maxKW": 150,
  "maxKw": 150,
  "type": "ac",
  "visibility": "public",
  "showOnMap": true,
  "driverSupportVisibility": "inherit",
  "note": "In order to access this site enter 0000 as code at the gate.",
  "location": {
    "coordinates": {
      "latitude": 55.6760968,
      "longitude": 12.5683371
    },
    "addressLabel": "Strandboulevarden 122, 5. sal, 2100 København, Denmark",
    "address": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "countrySubdivisionCode": "US-GA",
      "country": "Denmark",
      "countryAreaId": 1
    }
  },
  "connectors": [
    {
      "id": 1,
      "identifier": "ccs",
      "name": "CCS"
    }
  ],
  "metadata": {
    "atm": true,
    "digitalChargePriceDisplay": false,
    "driverLounge": true,
    "fuelStation": false,
    "parkingArea": true,
    "powerSupply": true,
    "shower": false,
    "vendingMachine": true,
    "washingMachine": false,
    "wifi": true,
    "toilets": 2,
    "cafe": true,
    "foodDelivery": false,
    "hotel": true,
    "mall": false,
    "museum": true,
    "park": true,
    "outdoorGym": false,
    "recreationArea": true,
    "restaurant": true,
    "supermarket": false,
    "airport": false,
    "bikeSharing": true,
    "busStop": true,
    "carpoolParking": false,
    "metroStation": true,
    "taxiStand": false,
    "tramStop": true,
    "secureTruckParking": false,
    "truckDealership": true,
    "truckParking": true,
    "truckRepair": false,
    "truckWash": true,
    "accessControlledArea": true,
    "cameraSurveillance": false,
    "entryGate": true,
    "exitGate": false,
    "floodLighting": true,
    "guard": false,
    "licensePlateRecognition": true,
    "pedestrianTurnstiles": false,
    "perimeterFence": true,
    "energyMix": {
      "isGreenEnergy": true,
      "energySources": [
        {
          "source": "SOLAR",
          "percentage": 40
        }
      ],
      "environmentImpact": [
        {
          "category": "CO2",
          "amount": 12.5
        }
      ],
      "supplierName": "Green Energy Supplier",
      "energyProductName": "EcoPower 2025"
    },
    "pictures": [
      "https://example.com/picture1.jpg",
      "https://example.com/picture2.jpg"
    ],
    "siteDeveloper": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "companyRegistrationNumber": "12345678"
    },
    "cafeAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "foodDeliveryAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "hotelAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "mallAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "museumAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "parkAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "outdoorGymAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "recreationAreaAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "restaurantAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "supermarketAddress": {
      "address1": "Strandboulevarden 122",
      "address2": "København",
      "address3": "5. sal",
      "zip": "2100",
      "city": "Copenhagen",
      "province": "Lombardy",
      "country": "Denmark",
      "countryAreaId": 1
    },
    "parkingType": "onDriveway",
    "roofed": true,
    "lighting": true,
    "openingDate": "2023-01-01",
    "openingHours": {
      "openingTimes": {
        "twentyFourSeven": false,
        "regularHours": {
          "weekday": 1,
          "periodBegin": "08:00",
          "periodEnd": "17:00"
        },
        "exceptionalOpenings": {
          "periodBegin": "08:00",
          "periodEnd": "17:00"
        },
        "exceptionalClosings": {
          "periodBegin": "08:00",
          "periodEnd": "17:00"
        }
      },
      "chargingWhenClosed": true
    },
    "totalParkingSpaces": 100,
    "totalAccessibleSpace": 10,
    "truckOnly": false,
    "trailerParking": true,
    "facilities": "Road",
    "venueWithAccessibility": true
  }
}

json

application/json

Delete an existing (charge) site

DELETE

https://partner-api.monta.com

/api/v1/sites/{siteId}

Note: This action will also remove Charge Points from the Site.

Required scope: charge-points:delete
Organization authorization: supported

Delete an existing (charge) site › path Parameters

siteId

integer · int64 · required

Delete an existing (charge) site › Responses

Site deleted

No data returned

Retrieve the amenities of a (charge) site

GET

https://partner-api.monta.com

/api/v1/sites/{siteId}/amenities

Required scope: charge-points:read
Organization authorization: supported

Retrieve the amenities of a (charge) site › path Parameters

siteId

integer · int64 · required

Retrieve the amenities of a (charge) site › Responses

Amenities of the site with the provided id

SiteAmenities

Amenity[] · required

List of amenities configured for the site

Replace the amenities of a (charge) site

PUT

https://partner-api.monta.com

/api/v1/sites/{siteId}/amenities

Replaces the full set of amenities on the site.

Required scope: charge-points:write
Organization authorization: supported

Replace the amenities of a (charge) site › path Parameters

siteId

integer · int64 · required

Replace the amenities of a (charge) site › Request Body

SiteAmenitiesUpdate

AmenityUpdate[] · required

Full list of amenities to set on the site. Replaces any existing amenities.

Replace the amenities of a (charge) site › Responses

Amenities updated

SiteAmenities

Amenity[] · required

List of amenities configured for the site

Retrieve the developer details of a (charge) site

GET

https://partner-api.monta.com

/api/v1/sites/{siteId}/developer-details

Required scope: charge-points:read
Organization authorization: supported

Retrieve the developer details of a (charge) site › path Parameters

siteId

integer · int64 · required

Retrieve the developer details of a (charge) site › Responses

Developer details for the site with the provided id

SiteDeveloper

name

string | null

Name of the developer

Example: John Doe

email

string | null

Email of the developer

Example: john.doe@example.com

companyRegistrationNumber

string | null

Company registration number

Example: 12345678

Update the developer details of a (charge) site

PUT

https://partner-api.monta.com

/api/v1/sites/{siteId}/developer-details

Required scope: charge-points:write
Organization authorization: supported

Update the developer details of a (charge) site › path Parameters

siteId

integer · int64 · required

Update the developer details of a (charge) site › Request Body

SiteDeveloperRequest

name

string | null

Developer name

Example: John Doe

email

string | null · email

Developer email

Example: john.doe@example.com

companyRegistrationNumber

string | null

Company registration number

Example: 12345678

Update the developer details of a (charge) site › Responses

Updated developer details for the site

SiteDeveloper

name

string | null

Name of the developer

Example: John Doe

email

string | null

Email of the developer

Example: john.doe@example.com

companyRegistrationNumber

string | null

Company registration number

Example: 12345678

Retrieve the energy mix of a (charge) site

GET

https://partner-api.monta.com

/api/v1/sites/{siteId}/energy-mix

Required scope: charge-points:read
Organization authorization: supported

Retrieve the energy mix of a (charge) site › path Parameters

siteId

integer · int64 · required

Retrieve the energy mix of a (charge) site › Responses

Energy mix of the site with the provided id

Energy mix information for a site

SiteEnergyMix

EnergySourceItem[] · required

List of energy sources with their category and percentage

EnvironmentalImpactItem[] · required

List of environmental impacts for this energy mix

is_green_energy

boolean | null

Indicates if the energy is green

Example: true

supplier_name

string | null

Name of the energy supplier

Example: Green Energy Supplier

energy_product_name

string | null

Name of the energy product

Example: EcoPower 2025

Update the energy mix of a (charge) site

PUT

https://partner-api.monta.com

/api/v1/sites/{siteId}/energy-mix

Required scope: charge-points:write
Organization authorization: supported

Update the energy mix of a (charge) site › path Parameters

siteId

integer · int64 · required

Update the energy mix of a (charge) site › Request Body

EnergyMixRequest

isGreenEnergy

boolean | null

Whether the site's electricity comes from renewable sources. true is a claim that has to be backed up in the same energy mix by at least one of: supplier_name, energy_product_name, or energy_sources with percentages adding up to 100. Blank names and partial source lists don't count, and the request is rejected with a 422. false or null needs no other fields.

Example: true

array | null

List of energy sources with their category and percentage

array | null

List of environmental impacts for this energy mix

supplierName

string | null

Name of the energy supplier

Example: Green Energy Supplier

energyProductName

string | null

Name of the energy product

Example: EcoPower 2025

Update the energy mix of a (charge) site › Responses

Energy mix updated

Energy mix information for a site

SiteEnergyMix

EnergySourceItem[] · required

List of energy sources with their category and percentage

EnvironmentalImpactItem[] · required

List of environmental impacts for this energy mix

is_green_energy

boolean | null

Indicates if the energy is green

Example: true

supplier_name

string | null

Name of the energy supplier

Example: Green Energy Supplier

energy_product_name

string | null

Name of the energy product

Example: EcoPower 2025

PUT/api/v1/sites/{siteId}/energy-mix

curl https://partner-api.monta.com/api/v1/sites/:siteId/energy-mix \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "isGreenEnergy": true,
  "energySources": [
    {
      "source": "SOLAR",
      "percentage": 40
    }
  ],
  "environImpact": [
    {
      "category": "CARBON_DIOXIDE",
      "amount": 12.5
    }
  ],
  "supplierName": "Green Energy Supplier",
  "energyProductName": "EcoPower 2025"
}'

Example Request Body

{
  "isGreenEnergy": true,
  "energySources": [
    {
      "source": "SOLAR",
      "percentage": 40
    }
  ],
  "environImpact": [
    {
      "category": "CARBON_DIOXIDE",
      "amount": 12.5
    }
  ],
  "supplierName": "Green Energy Supplier",
  "energyProductName": "EcoPower 2025"
}

json

Example Responses

{
  "is_green_energy": true,
  "energy_sources": [
    {
      "source": "SOLAR",
      "percentage": 40
    }
  ],
  "environ_impact": [
    {
      "category": "CARBON_DIOXIDE",
      "amount": 12.5
    }
  ],
  "supplier_name": "Green Energy Supplier",
  "energy_product_name": "EcoPower 2025"
}

json

application/json

Retrieve the images of a (charge) site

GET

https://partner-api.monta.com

/api/v1/sites/{siteId}/images

Required scope: charge-points:read
Organization authorization: supported

Retrieve the images of a (charge) site › path Parameters

siteId

integer · int64 · required

Retrieve the images of a (charge) site › Responses

Images of the site

SiteImages

images

string[] · required

Public URLs of the images attached to this site (max 4)

Example: ["https://cdn.monta.com/charge-point-group-pictures/abc.jpg"]

Upload an image to a (charge) site

POST

https://partner-api.monta.com

/api/v1/sites/{siteId}/images

Uploads a jpeg/png image (max 2MB, max 4 per site) and returns the updated list of image URLs. Required scope: charge-points:write
Organization authorization: supported

Upload an image to a (charge) site › path Parameters

siteId

integer · int64 · required

Upload an image to a (charge) site › Request Body

image

string · required

Upload an image to a (charge) site › Responses

Image uploaded, updated list of image URLs returned

SiteImages

images

string[] · required

Public URLs of the images attached to this site (max 4)

Example: ["https://cdn.monta.com/charge-point-group-pictures/abc.jpg"]

Delete an image from a (charge) site

DELETE

https://partner-api.monta.com

/api/v1/sites/{siteId}/images

Removes the image with the provided public url and returns the remaining image URLs. Required scope: charge-points:delete
Organization authorization: supported

Delete an image from a (charge) site › path Parameters

siteId

integer · int64 · required

Delete an image from a (charge) site › query Parameters

url

string · required

Delete an image from a (charge) site › Responses

Image deleted, remaining list of image URLs returned

SiteImages

images

string[] · required

Public URLs of the images attached to this site (max 4)

Example: ["https://cdn.monta.com/charge-point-group-pictures/abc.jpg"]

Update the opening hours of a (charge) site

PUT

https://partner-api.monta.com

/api/v1/sites/{siteId}/opening-hours

Required scope: charge-points:write
Organization authorization: supported

Update the opening hours of a (charge) site › path Parameters

siteId

integer · int64 · required

Update the opening hours of a (charge) site › Request Body

OpeningHoursRequest

object

Opening times for the location

chargingWhenClosed

boolean | null

Indicates if charging is allowed when closed

Example: true

Update the opening hours of a (charge) site › Responses

Opening hours updated

OpeningHour

object

Opening times for the location

chargingWhenClosed

boolean | null

Indicates if charging is allowed when closed

Example: true

PUT/api/v1/sites/{siteId}/opening-hours

curl https://partner-api.monta.com/api/v1/sites/:siteId/opening-hours \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "openingTimes": {
    "twentyFourSeven": false,
    "regularHours": [
      {
        "weekday": 1,
        "periodBegin": "08:00",
        "periodEnd": "17:00"
      }
    ],
    "exceptionalOpenings": [
      {
        "periodBegin": "2025-06-01T08:00:00Z",
        "periodEnd": "2025-06-01T18:00:00Z"
      }
    ],
    "exceptionalClosings": [
      {
        "periodBegin": "2025-06-01T08:00:00Z",
        "periodEnd": "2025-06-01T18:00:00Z"
      }
    ]
  },
  "chargingWhenClosed": true
}'

Example Request Body

{
  "openingTimes": {
    "twentyFourSeven": false,
    "regularHours": [
      {
        "weekday": 1,
        "periodBegin": "08:00",
        "periodEnd": "17:00"
      }
    ],
    "exceptionalOpenings": [
      {
        "periodBegin": "2025-06-01T08:00:00Z",
        "periodEnd": "2025-06-01T18:00:00Z"
      }
    ],
    "exceptionalClosings": [
      {
        "periodBegin": "2025-06-01T08:00:00Z",
        "periodEnd": "2025-06-01T18:00:00Z"
      }
    ]
  },
  "chargingWhenClosed": true
}

json

Example Responses

{
  "openingTimes": {
    "twentyFourSeven": false,
    "regularHours": {
      "weekday": 1,
      "periodBegin": "08:00",
      "periodEnd": "17:00"
    },
    "exceptionalOpenings": {
      "periodBegin": "08:00",
      "periodEnd": "17:00"
    },
    "exceptionalClosings": {
      "periodBegin": "08:00",
      "periodEnd": "17:00"
    }
  },
  "chargingWhenClosed": true
}

json

application/json

Schedules Split Billing