Schemas

Address

address1

string · required

First line of address

Example: Strandboulevarden 122

zip

string · required

Zip-code

Example: 2100

city

string · required

City (readable)

Example: Copenhagen

country

string · required

Country (readable)

Example: Denmark

address2

string | null

Second line of address

Example: København

address3

string | null

Third line of address

Example: 5. sal

Application

id

integer · int64 · required

userId

integer · int64 · required

name

string · required

clientId

string · required

scopes

AuthScope[] · required

Enum values:

all

charge-points

charge-transactions

control-charging

clientSecret

string | null

createdAt

string | null · date-time

updatedAt

string | null · date-time

ApplicationAccessToken

accessToken

string · required

User access token, required to manage applications.

Example: 5a6d4da1-6af3-420b-9c15-6ecb5f6de199

accessTokenExpirationDate

string · date-time · required

Expiration date of access token (1 hour)

Example: 2022-05-11T07:03:04.675035Z

refreshToken

string · required

Refresh token, required to get a new access token.

Example: 83b766d4-476e-4dd1-b11e-f57e856c890d

refreshTokenExpirationDate

string · date-time · required

Expiration date of refresh token (30 days)

Example: 2023-05-12T07:03:04.675055Z

applicationId

integer · int64

ID of application linked to this access token.

Example: 42

userId

integer · int64

ID of user linked to this access token.

Example: 42

AuthScope

string · enum

Enum values:

all

charge-points

charge-transactions

control-charging

A scope granted to your access.

Example: all

Charge

createdAt

string · date-time · required

Creation date

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

updatedAt

string · date-time · required

Update date

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

state

string · enum · required

State of the charge

Enum values:

reserved

starting

charging

stopping

paused

scheduled

stopped

completed

Example: charging

humanReadableId

string · required

The human readable id for this charge

Example: 0000-0000-0005M

id

integer · int64

Id of the charge

Example: 1

chargePointId

integer · int64

Id of the charge point related to this charge

Example: 21

cablePluggedInAt

string | null · date-time

Date when cable was plugged in

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

startedAt

string | null · date-time

Date when charge started

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

stoppedAt

string | null · date-time

Date when charge stopped

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

fullyChargedAt

string | null · date-time

Date when EV was fully charged

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

failedAt

string | null · date-time

Date when charge failed

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

timeoutAt

string | null · date-time

Date when charge timed out

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

consumedKwh

number | null · double

Consumed Kwh

Example: 20.4

kwhLimit

number | null · double

Configured Kwh limit for this charge

Example: 21

startMeterKwh

number | null · double

Kwh of the meter before charging started

Example: 123.45

endMeterKwh

number | null · double

Kwh of the meter after charging stopped

Example: 163.85

cost

number | null

Cost for this charge (if configured)

Example: 22.4

price

number | null

Price for this charge

Example: 122.4

priceLimit

number | null

Configured price limit for this charge

Example: 212

averagePricePerKwh

number | null

Average price per Kwh

Example: 6

averageCo2PerKwh

number | null · double

Average CO2 consumption per Kwh

Example: 100

averageRenewablePerKwh

number | null · double

Average percentage of renewable energy per Kwh

Example: 72.5

failureReason

string | null

Failure reason for this charge

Example: Some reason why we couldn't charge.

stopReason

string | null

Reason why this charge stopped

Example: Some reason why the charge stopped.

note

string | null

A note taken for this charge

Example: Lorem Ipsum

object

Currency used for payment.

object

Information about the state of charge if available

Example: 42

socLimit

number | null · double

Configured SoC limit for this charge

Example: 80

ChargeKwhConsumption

chargeId

integer · int64

Id of the charge

Example: 1

consumptionPeriodSizeInSeconds

integer · int64

Specifies the time interval, in seconds

Example: 3600

array | null

Detailed breakdown of the kwh consumption in time interval of 5, 10, 15, 30 and 60 minutes
Note: Representation is in seconds

Default: 3600

ChargePoint

createdAt

string · date-time · required

Creation date of this charge point

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

updatedAt

string · date-time · required

Date this charge point was last updated

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

visibility

string · enum · required

Indicates if this charge point is public or private

Enum values:

private

public

Example: public

object · required

Location information for this charge point

Connector[] · required

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

id

integer · int64

Id of this charge point

Example: 1

serialNumber

string | null

Serial number of this charge point

name

string | null

Name of the site

Example: Monta CPH HQ

maxKw

number | null · double

Max KW available at this charge point.

Example: 150

type

string | null · enum

Type of charge point (AC / DC)

Enum values:

Example: ac

note

string | null

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

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

state

string | null · enum

Chargepoint state

Enum values:

available

busy

busy-blocked

busy-charging

busy-non-charging

busy-non-released

busy-reserved

busy-scheduled

Example: available

lastMeterReadingKwh

number | null · double

Last meter reading (KWH) for this charge point

Example: 913.2

cablePluggedIn

boolean

Indicates if a cable is plugged in (true)

Example: true

brandName

string | null

Brand name for this charge point

Example: Easee

modelName

string | null

Model name for this charge point

Example: Easee - Home

firmwareVersion

string | null

Current firmware version for this charge point

Example: v1

Connector

identifier

string · required

Identifier of connector

Example: ccs

name

string · required

Readable name of connector

Example: CCS

Coordinates

latitude

number · double

Latitude value of coordinate

Example: 55.6760968

longitude

number · double

Longitude value of coordinate

Example: 12.5683371

Country

id

integer · int64 · required

code

string · required

name

string · required

currencyCode

string · required

currencyName

string · required

Currency

identifier

string · required

Currency identifier, e.g. DKK

Example: DKK

name

string · required

Readable name of currency

Example: Danish krone

decimals

integer · int32

Number of decimals for this currency

Example: 2

DatexIIAddress

Postal address

postcode

string | null

Postal code

Example: 2100

object

City name

countryCode

string | null

ISO 3166-1 alpha-2 country code

Example: DK

array | null

Address lines

DatexIIAddressLine

A single line of an address

object · required

Type of address line (e.g. streetName)

object · required

Address line text

order

integer · int32

Order index of this line in the address

DatexIIAmenities

Parking space amenities

roofed

boolean | null

Whether the parking space is under a roof

lighting

boolean | null

Whether the parking space has artificial lighting

DatexIIAnOrganisation

Organisation details

object · required

Organisation name

object

Contact details

DatexIIBulkStatusPublication

DATEX II EnergyInfrastructureStatusPublication — a batch of EVSE statuses that changed since a cursor

lang

string · required

ISO 639-1 language code

Example: en

publicationTime

string · required

ISO 8601 timestamp of when this publication was generated.

Example: 2026-06-28 01:01:51.151000000

cursor

string · required

Opaque continuation token. Pass it back as the cursor query param to fetch the next page, and keep going while hasMore is true. Treat it as opaque — do not parse, construct or modify it. On an empty batch it still points at the current position, so you can resume polling from here.

hasMore

boolean · required

True while more pages remain; false once you have caught up. Keep paging (cursor = this response's cursor) while true. Once false, hold the cursor and poll periodically — new changes surface past it.

Example: false

object · required

Publisher identification

DatexIIElectricChargingPointStatus[] · required

EVSE statuses in this page, at most perPage entries (one row per EVSE). Keep paging with the returned cursor while hasMore is true.

DatexIIConnector

Charging connector specification

object · required

Connector type (e.g. iec62196T2, iec62196T2Combo, chademo)

object

Connector format — 'socket' or 'cable'

object

Charging mode (e.g. mode3AC3p, mode4DC)

maxPowerAtSocket

number | null · double

Maximum power output in watts

Example: 22000

voltage

number | null · double

Voltage in volts

Example: 400

maximumCurrent

number | null · double

Maximum current in amperes

Example: 32

array | null

External identifiers for this connector

DatexIIContactDetails

Contact information

telephoneNumber

string | null

Contact phone number

DatexIIDedicatedParkingSpaces

Parking spaces associated with a charging point

idG

string · required

DATEX II global identifier

versionG

string · required

DATEX II entity version

numberOfSpaces

integer · int32

Number of parking spaces of this type

array | null

Vehicle types and dimension constraints

object

Parking space amenities

DatexIIElectricChargingPoint

An EVSE (Electric Vehicle Supply Equipment) refill point

idG

string · required

DATEX II global identifier

versionG

string · required

DATEX II entity version

object · required

Unit in which energy delivery is measured

object · required

AC or DC current type

array | null

External identifiers — includes the OCPI EVSE ID

array | null

Connector specifications

array | null

Energy mix / renewable source info

array | null

Ad-hoc pricing — omitted when CPO has no pricing configured

array | null

Parking spaces associated with this charging point

DatexIIElectricChargingPointStatus

Dynamic status of a single EVSE

evseId

string · required

OCPI EVSE identifier

Example: DK*MON*E100001

availabilityStatus

string · enum · required

Current availability status

Enum values:

available

occupied

outOfService

reserved

unknown

lastUpdated

string · required

ISO 8601 timestamp of last status update

array | null

Ad-hoc pricing — omitted when CPO has no pricing configured

DatexIIElectricEnergy

Electric energy pricing group carrying one or more EnergyRates

DatexIIEnergyRate[] · required

Pricing rates applicable to this energy group

DatexIIElectricEnergyMix

Energy source information

energyMixIndex

integer · int32

Index linking this entry between static and dynamic publications

isGreenEnergy

boolean | null

True if 100% from renewable sources

DatexIIEnergyPrice

A single price component (DATEX II AFIR EnergyPrice)

object · required

Price type — spec-valid PriceTypeEnum values used here: pricePerKWh, basePrice, pricePerMinute, other

value

number · double

Price amount in the rate's applicableCurrency

Example: 0.35

taxIncluded

boolean | null

Whether the price already includes applicable tax/VAT

taxRate

number | null · double

Applicable VAT rate as a percentage (e.g. 25 for 25% DK VAT)

Example: 25

object

Time window in which this price applies — carries the fromMinute threshold that distinguishes a time-triggered fee (idle / overstay / after-session) from an immediate one

object

Free-text note clarifying the price — e.g. the idle-fee explanation attached to priceType 'other'

DatexIIEnergyRate

A pricing rate with one or more price components (DATEX II AFIR EnergyRate)

idG

string · required

Unique identifier for this rate entry

object · required

Pricing policy, e.g. adHoc or contract

applicableCurrency

string[] · required

ISO 4217 currency codes this rate applies to

Example: ["DKK"]

lastUpdated

string · required

ISO 8601 timestamp of when this rate was last updated

DatexIIEnergyPrice[] · required

Price components for this rate

DatexIIEnumValue

DATEX II enumeration wrapper with optional extension

value

string · required

Enum value, use 'extendedG' for project-specific types

extendedValueG

string | null

Project-specific type name when value is 'extendedG'

DatexIIExceptionalPeriod

An exceptional opening or closing period

period_begin

string · required

ISO 8601 datetime start

period_end

string · required

ISO 8601 datetime end

DatexIIExternalIdentifier

External identifier for cross-referencing

identifier

string · required

The external identifier value

Example: DK*MON*E100001

object

Type of identifier

DatexIIFacilityLocation

Facility location with address and timezone

object

Postal address

timeZone

string | null

ISO 8601 timezone identifier

Example: Europe/Copenhagen

DatexIIGrossWeightCharacteristic

Vehicle gross weight constraint

object · required

Comparison operator

grossVehicleWeight

number · double

Maximum gross vehicle weight in tonnes

DatexIIHeightCharacteristic

Vehicle height constraint

object · required

Comparison operator

vehicleHeight

number · double

Maximum vehicle height in metres

DatexIIInternationalIdentifier

International identifier of the publication creator

country

string · required

ISO 3166-1 alpha-2 country code

Example: DK

nationalIdentifier

string · required

National identifier of the publisher

Example: MON

DatexIILengthCharacteristic

Vehicle length constraint

object · required

Comparison operator

vehicleLength

number · double

Maximum vehicle length in metres

DatexIILocalizedValue

A single localized text value

lang

string · required

ISO 639-1 two-letter language code

Example: en

value

string · required

The localized text value

DatexIILocationExtension

DATEX II location extension with facility details

object

Facility location details

DatexIILocationReference

Location reference for a site

object

Point location

DatexIIMultilingualString

Multilingual text with one or more language variants

DatexIILocalizedValue[] · required

List of localized text values

DatexIIOperatingHours

Operating hours — open 24/7 or weekly schedule

object | null

Present (empty object) when the facility is open 24/7

object

Weekly schedule with optional exceptional periods

DatexIIOperatingHoursSpecification

Weekly schedule with optional exceptional periods

array | null

Recurring weekly schedule

array | null

Exceptional opening periods

array | null

Exceptional closing periods

DatexIIOrganisation

DATEX II organisation wrapper

object · required

Organisation details

DatexIIPaginationMeta

Pagination metadata

page

integer · int32

Current page number (1-based)

Example: 1

perPage

integer · int32

Number of items per page

Example: 100

total

integer · int32

Total number of sites across all pages

Example: 7095

DatexIIPointByCoordinates

object · required

Geographic coordinates

DatexIIPointCoordinates

Geographic coordinates in WGS84

latitude

number · double

Latitude in decimal degrees (WGS84)

Example: 55.6761

longitude

number · double

Longitude in decimal degrees (WGS84)

Example: 12.5683

DatexIIPointLocation

Point location with coordinates and facility extension

object

Point defined by coordinates

object

Location extension with facility details

DatexIIRegularHours

A single recurring weekly time window

period_begin

string · required

Start time in HH:MM format

Example: 08:00

period_end

string · required

End time in HH:MM format

Example: 22:00

weekday

integer · int32 · min: 1 · max: 7

Day of week: 1=Monday, 7=Sunday

Example: 1

DatexIIServiceType

Service type at a station

object · required

Service type (e.g. unattended)

DatexIISite

A physical charging site (EnergyInfrastructureSite)

idG

string · required

DATEX II global identifier

versionG

string · required

DATEX II entity version

object

Display name of the site

object

Site type (e.g. parkingLot, street, parkingGarage)

object

Operating hours — 24/7 or weekly schedule, null if unknown

object

Geospatial coordinates and address

object

Charge point operator

object

Legal owner of the site

object

Helpdesk contact organisation

array | null

Parking spaces at this site

array | null

Charging stations at this site

DatexIIStation

An energy infrastructure station (OCPP charger box)

idG

string · required

DATEX II global identifier

versionG

string · required

DATEX II entity version

DatexIIServiceType[] · required

Service types available at this station

totalMaximumPower

number · double

Total maximum power of all charge points in watts

Example: 150000

numberOfRefillPoints

integer · int32

Number of charging points (EVSEs) at this station

array | null

Charging points (EVSEs) at this station

DatexIIStatusPublication

DATEX II EnergyInfrastructureStatusPublication — dynamic EVSE status

lang

string · required

ISO 639-1 language code

Example: en

publicationTime

string · required

ISO 8601 timestamp when this publication was generated

object · required

Publisher identification

object · required

EVSE status data

DatexIITable

Energy infrastructure table containing sites

idG

string · required

DATEX II global identifier for this table

versionG

string · required

DATEX II entity version

array | null

List of energy infrastructure sites

DatexIITablePublication

DATEX II EnergyInfrastructureTablePublication — static charge point data

lang

string · required

ISO 639-1 language code for text fields

Example: en

publicationTime

string · required

ISO 8601 timestamp when this publication was generated

object · required

Publisher identification

DatexIITable[] · required

Energy infrastructure tables containing sites

object · required

Pagination metadata

DatexIITimeBasedApplicability

The time window in which a price applies (DATEX II AFIR TimeBasedApplicability)

fromMinute

integer | null · int32

Minute from which this price starts applying — e.g. an idle fee that begins N minutes after charging ends

Example: 60

DatexIIVehicleCharacteristics

Vehicle type and dimension constraints

array | null

Applicable vehicle types (e.g. car, bus, motorcycle)

array | null

Height constraints

array | null

Length constraints

array | null

Width constraints

array | null

Gross weight constraints

DatexIIWidthCharacteristic

Vehicle width constraint

object · required

Comparison operator

vehicleWidth

number · double

Maximum vehicle width in metres

DetectLocationResponse

DetectedCountry · required

detectedLanguage

string · required

isReliable

boolean · required

Country[] · required

warningMessage

string | null

DetectedCountry

id

integer · int64 · required

code

string · required

name

string · required

currencyCode

string · required

currencyName

string · required

isSanctioned

boolean · required

KwhConsumption

time

string · date-time · required

Time interval

Example: 2022-05-12T15:00:00Z

value

number · double

The amount of energy consumed (in kWh) during the corresponding time interval

Example: 15.8

Location

object

Coordinates (lat, lng)

object

Address

MontaPage.Meta

itemCount

integer · int32 · required

currentPage

integer · int32 · required

perPage

integer · int32 · required

totalPageCount

integer · int32 · required

totalItemCount

integer · int64 · required

MontaPage_ChargeDto_

Charge[] · required

MontaPage.Meta · required

MontaPage_ChargePointDto_

ChargePoint[] · required

MontaPage.Meta · required

MontaPage_TransactionDto_

Transaction[] · required

MontaPage.Meta · required

OpenDataAdditionalGeoLocation

latitude

string · required

longitude

string · required

object

Name of the point in local language or as written at the location

OpenDataBusinessDetails

name

string | null

Name of the operator

Example: Monta ApS

website

string | null

Link to the operator's website

Example: https://monta.com

object

Image link to the operator's logo

OpenDataCapability

string · enum

Enum values:

CHARGING_PROFILE_CAPABLE

CHARGING_PREFERENCES_CAPABLE

CHIP_CARD_SUPPORT

CONTACTLESS_CARD_SUPPORT

CREDIT_CARD_PAYABLE

DEBIT_CARD_PAYABLE

PED_TERMINAL

REMOTE_START_STOP_CAPABLE

OpenDataConnector

OCPI 2.2.1 Connector object

id

string · required

Identifier of the Connector within the EVSE

standard

string · enum

The standard of the installed connector

Enum values:

CHADEMO

CHAOJI

DOMESTIC_A

DOMESTIC_B

DOMESTIC_C

DOMESTIC_D

DOMESTIC_E

DOMESTIC_F

format

string · enum

The format (socket/cable) of the installed connector

Enum values:

SOCKET

CABLE

power_type

string · enum

Type of power delivered by the connector

Enum values:

AC_1_PHASE

AC_2_PHASE

AC_2_PHASE_SPLIT

AC_3_PHASE

max_voltage

integer | null · int32

Maximum voltage of the connector

Example: 400

max_amperage

integer | null · int32

Maximum amperage of the connector

Example: 32

max_electric_power

integer | null · int32

Maximum electric power that can be delivered by this connector, in Watts (W)

tariff_ids

array | null

Identifiers of the currently valid charging Tariffs. Always listed, whether or not the EVSE's tariffs field embeds the matching Tariff object

terms_and_conditions

string | null

URL to the operator's terms and conditions

last_updated

string | null

Timestamp of when this Connector was last updated

OpenDataConnectorFormat

string · enum

Enum values:

SOCKET

CABLE

OpenDataConnectorType

string · enum

Enum values:

CHADEMO

CHAOJI

DOMESTIC_A

DOMESTIC_B

DOMESTIC_C

DOMESTIC_D

DOMESTIC_E

DOMESTIC_F

OpenDataDisplayText

language

string | null

Language code (ISO 639-1)

Example: en

text

string | null

Text in the corresponding language

OpenDataEnergyMix

is_green_energy

boolean

True if 100% from regenerative sources

array | null

Key-value pairs of energy sources used in this location

array | null

Key-value pairs of environmental impact values

supplier_name

string | null

Name of the energy supplier, delivering the energy

energy_product_name

string | null

Name of the energy supplier's product/tariff plan

OpenDataEnergySource

source

string · required

Energy source category, e.g. NUCLEAR, GENERAL_FOSSIL, COAL, GAS, GENERAL_GREEN, SOLAR, WIND, WATER

percentage

number · double

Percentage of this source (0-100)

OpenDataEnvironmentalImpact

category

string | null

Impact category, e.g. NUCLEAR_WASTE, CARBON_DIOXIDE

amount

number · double

Amount of this part in g/kWh

OpenDataEvse

OCPI 2.2.1 EVSE object

uid

string · required

Uid of the EVSE

Example: 45805

evse_id

string | null

Compliant with eMI3 standard

Example: DK*MON*E45805

status

string · enum

Indicates the current status of the EVSE

Enum values:

AVAILABLE

BLOCKED

CHARGING

INOPERATIVE

OUTOFORDER

PLANNED

REMOVED

RESERVED

array | null

Indicates a planned status update of the EVSE

capabilities

array | null

List of functionalities the EVSE is capable of

Enum values:

CHARGING_PROFILE_CAPABLE

CHARGING_PREFERENCES_CAPABLE

CHIP_CARD_SUPPORT

CONTACTLESS_CARD_SUPPORT

CREDIT_CARD_PAYABLE

DEBIT_CARD_PAYABLE

PED_TERMINAL

REMOTE_START_STOP_CAPABLE

array | null

List of available connectors on the EVSE

floor_level

string | null

Level on which the charging station is located

object

Coordinates of the EVSE

physical_reference

string | null

A number/string printed on the outside of the EVSE for visual identification

object

Multi-language human-readable directions when more detailed information is needed

parking_restrictions

array | null

Restrictions that apply to the parking spot

Enum values:

EV_ONLY

PLUGGED

DISABLED

CUSTOMERS

MOTORCYCLES

array | null

Links to images related to the EVSE

last_updated

string | null

Timestamp of when this EVSE, or one of its Connectors, was last updated

array | null

OCPI 2.2.1 Tariffs applicable on this EVSE (Monta extension). A tariff's id matches a connector's tariff_ids entry. A tariff is only embedded when the charge point is roaming-enabled and its operator has tariff embedding enabled; otherwise this list is empty, even when the connectors list tariff_ids

ocpp_identity

string | null

OCPP identity of the charge point (Monta extension)

OpenDataEvseStatus

string · enum

Enum values:

AVAILABLE

BLOCKED

CHARGING

INOPERATIVE

OUTOFORDER

PLANNED

REMOVED

RESERVED

OpenDataExceptionalPeriod

period_begin

string · required

period_end

string · required

OpenDataFacility

string · enum

Enum values:

HOTEL

RESTAURANT

CAFE

MALL

SUPERMARKET

SPORT

RECREATION_AREA

NATURE

OpenDataGeoLocation

latitude

string · required

Latitude of the point in decimal degrees

Example: 51.185900

longitude

string · required

Longitude of the point in decimal degrees

Example: 0.292873

OpenDataHours

twentyfourseven

boolean | null

True if the location is open 24/7

array | null

Regular hours, weekday-based; only to be used if twentyfourseven=false

array | null

Exceptions for specified calendar dates, time-range based

array | null

Exceptions for specified calendar dates, time-range based

OpenDataImage

url

string · required

URL from where the image data can be fetched through a web browser

thumbnail

string | null

URL from where a thumbnail of the image can be fetched

category

string | null

Image category, e.g. NETWORK, OPERATOR, LOCATION, OWNER, CHARGER, ENTRANCE, OTHER

type

string | null

Image type (file extension) like png, jpeg, jpg, gif, svg

width

integer | null · int32

Width of the full-scale image in pixels

height

integer | null · int32

Height of the full-scale image in pixels

OpenDataLocation

OCPI 2.2.1 Location object

id

string · required

Uid of the Location object

Example: c45805

country_code

string | null

ISO-3166 alpha-2 country code of the CPO that 'owns' this Location

Example: DK

party_id

string | null

CPO id (3 alphanumeric chars) issued by the country authority

Example: MON

publish

boolean | null

Defines if the Location may be published on a website / app etc.

array | null

Restrictions on which Tokens may use this Location, when publish = false

name

string | null

Display name of the Location

Example: Monta HQ Garage

address

string | null

Street/block name and house number if available

Example: Vesterbrogade 1A

city

string | null

City or town

Example: Copenhagen

postal_code

string | null

Postal code of the Location

Example: 1620

state

string | null

State or province of the Location, only when relevant

country

string | null

ISO 3166-1 alpha-3 code for the country of this Location

Example: DNK

object

Coordinates of the Location

array | null

Geographical locations related to this Location, e.g. for entrances/exits

parking_type

string · enum

The general type of parking at the charge point location

Enum values:

ALONG_MOTORWAY

PARKING_GARAGE

PARKING_LOT

ON_DRIVEWAY

ON_STREET

UNDERGROUND_GARAGE

array | null

List of EVSEs that belong to this Location

object

Human-readable directions on how to reach the location

object

Information of the operator

object

Information of the sub-operator (if applicable)

object

Information of the owner (if applicable)

facilities

array | null

Optional list of facilities this charging location directly belongs to

Enum values:

HOTEL

RESTAURANT

CAFE

MALL

SUPERMARKET

SPORT

RECREATION_AREA

NATURE

time_zone

string | null

IANA time zone the Location is in

Example: Europe/Copenhagen

object

The times when the EVSEs at the location can be accessed for charging

charging_when_closed

boolean | null

Whether the EVSEs are still charging outside the opening hours of the location

array | null

Links to images related to the location

object

Details on the energy supplied at this location

last_updated

string | null

Timestamp of when this Location, or one of its EVSEs/Connectors, was last updated

OpenDataLocationsMeta

OpenDataLocationsPagination · required

Cursor-based pagination metadata

OpenDataLocationsPagination

Cursor-based pagination metadata

type

string · required

Pagination type

Example: cursor

count

integer · int32

Number of items in this page

Example: 1

per_page

integer · int32

Page size

Example: 100

before

integer | null · int64

First id in the page (use as before cursor for previous page)

Example: 8476

after

integer | null · int64

Last id in the page (use as after cursor for next page)

Example: 8476

has_more

boolean

True if more rows exist beyond this page

Example: false

OpenDataLocationsResponse

Paginated list of charge points in OCPI 2.2.1 Location format

OpenDataLocation[] · required

OCPI 2.2.1 Location objects

OpenDataLocationsMeta · required

OpenDataParkingRestriction

string · enum

Enum values:

EV_ONLY

PLUGGED

DISABLED

CUSTOMERS

MOTORCYCLES

OpenDataParkingType

string · enum

Enum values:

ALONG_MOTORWAY

PARKING_GARAGE

PARKING_LOT

ON_DRIVEWAY

ON_STREET

UNDERGROUND_GARAGE

OpenDataPowerType

string · enum

Enum values:

AC_1_PHASE

AC_2_PHASE

AC_2_PHASE_SPLIT

AC_3_PHASE

OpenDataPriceComponent

OCPI 2.2.1 PriceComponent object

type

string | null · enum

Tariff dimension this price component applies to

Enum values:

ENERGY

FLAT

PARKING_TIME

TIME

price

number | null

Price per unit (excl. VAT) for this tariff dimension

Example: 0.35

step_size

integer | null · int32

Minimum amount to be billed; the price is calculated per this step

Example: 1

vat

number | null

Applicable VAT percentage for this tariff dimension, if provided

Example: 20

OpenDataPublishTokenType

uid

string | null

type

string | null

visual_number

string | null

issuer

string | null

group_id

string | null

OpenDataRegularHours

period_begin

string · required

Begin of the regular period in HH:mm format

period_end

string · required

End of the regular period in HH:mm format

weekday

integer · int32

Day of the week, from Monday (1) to Sunday (7)

OpenDataStatusSchedule

period_begin

string · required

status

OpenDataEvseStatus · enum · required

Enum values:

AVAILABLE

BLOCKED

CHARGING

INOPERATIVE

OUTOFORDER

PLANNED

REMOVED

RESERVED

period_end

string | null

OpenDataTariff

OCPI 2.2.1 Tariff object (Monta extension); its id matches a connector's tariff_ids entry

id

string | null

Uniquely identifies the tariff within the CPO's platform

Example: GBMOTT25987

currency

string | null

ISO-4217 code of the currency of this tariff

Example: GBP

country_code

string | null

ISO-3166 alpha-2 country code of the CPO that owns this Tariff

Example: GB

party_id

string | null

CPO id (3 alphanumeric chars) of the CPO that owns this Tariff

Example: MOT

array | null

List of multi-language alternative tariff info texts

tariff_alt_url

string | null

URL to a web page with additional tariff information

array | null

List of tariff elements, each with price components and optional restrictions

object

Details on the energy supplied with this tariff

last_updated

string | null

Timestamp of when this Tariff was last updated

OpenDataTariffElement

OCPI 2.2.1 TariffElement object

array | null

List of price components that describe the pricing of a tariff

object

Restrictions that determine when this tariff element applies

OpenDataTariffRestriction

OCPI 2.2.1 TariffRestrictions object

start_time

string | null

Start time of day in local time, HH:mm, valid from this time of day

Example: 13:30

end_time

string | null

End time of day in local time, HH:mm, valid until this time of day

Example: 19:45

start_date

string | null

Start date in local time, YYYY-MM-DD, valid from this day (inclusive)

Example: 2026-10-01

end_date

string | null

End date, valid until this day (exclusive)

min_kwh

number | null · double

Minimum consumed energy in kWh for this tariff element to apply

max_kwh

number | null · double

Maximum consumed energy in kWh for this tariff element to apply

min_power

number | null · double

Minimum power in kW for this tariff element to apply

max_power

number | null · double

Maximum power in kW for this tariff element to apply

min_duration

integer | null · int32

Minimum charging duration in seconds for this tariff element to apply

max_duration

integer | null · int32

Maximum charging duration in seconds for this tariff element to apply

day_of_week

array | null

Days of the week this tariff element applies to: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

StartChargeRequest

chargePointId

integer · int64 · required

Id of the charge point used for this charge

Example: 21

StateOfCharge

source

string · enum · required

Source of this value, e.g vehicle or charge-point

Enum values:

charge-point

vehicle

Example: vehicle

percentage

number · double

Value of SoC in %

Example: 42.2

Transaction

state

string · enum · required

state of the transaction

Enum values:

complete

pending

failed

reserved

Example: complete

fromAmount

number · required

Amount sent

Example: 13.77

object · required

Currency for fromAmount.

toAmount

number · required

Amount received

Example: 13.77

object · required

Currency used for toAmount.

exchangeRate

number · required

Exchange rate used for currency conversion

Example: 1

createdAt

string · date-time · required

Creation date of this transaction

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

id

integer · int64

Id of the transaction

Example: 1

note

string | null

note of the transaction

summary

string | null

summary of the transaction

fromWalletId

integer | null · int64

Id of the wallet where the amount was sent from. Can be null if the transaction did not originate from a wallet.

Example: 1

toWalletId

integer | null · int64

Id of the wallet where the amount was sent to. Can be null if the transaction did not target a wallet.

Example: 2

updatedAt

string | null · date-time

Date this transaction was last updated

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

completedAt

string | null · date-time

Date this transaction was last completed

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

Wallet

ownerType

string · required

Type of owner: operator, team

Example: team

object · required

Currency used for this wallet.

id

integer · int64

Id of the wallet

Example: 1

ownerId

integer · int64

Id of the owner of this wallet, either a teamId or operatorId (depending on ownerType)

Example: 42

object

Balance of this wallet, if available (This field is not populated on the list endpoints).

WalletDto.BalanceDto

amount

number · double

Amount of the balance

Example: 13.77

credit

number · double

Amount of the credit

Example: 11.77