V2C Thirdparty API (1.0.0)

Download OpenAPI specification:

Introduction

This is the V2C RESTful API (Application Programming Interface), which facilitates interaction with V2C's web services. It enables remote control of charging devices, management of RFID credentials, retrieval of charging statistics, and configuration of specific device parameters.

This API allows you to integrate your e-Charger with self-developed applications or services, enabling the creation of custom automations and advanced functionalities for your charging points.

Authentication

The API uses a Bearer Token (API Key) for authentication. You must provide your personal token in the custom header apikey with every request. If the apikey is invalid or missing, the API will return a 401 Unauthorized error.

How to obtain your API Key

To obtain your authentication token, log in to v2c.cloud, navigate to the API section in the left-hand menu, and generate your key.

For more information, visit: https://v2charge.com/support/v2c-cloud/get-token-id-api-rest-cloud/

Rate Limiting

Each user is subject to a rate limit of 1000 daily calls (requests). Should you require a higher volume of calls, please contact V2C technical support.

All successful responses will include the following headers for usage monitoring:

RateLimit-Limit: The maximum number of requests allowed in the daily period (e.g., 1000).
RateLimit-Remaining: The number of requests remaining in the current daily period.

Device Control & Configuration

Commands to remotely control and configure the core charging behavior and settings of devices (POST Actions).

Start or Resume Charging Session

Initiates or resumes the charging session on the specified device.

Authorizations:

apiKeyAuth

query Parameters

deviceId

required

string

Example: deviceId=YOUR_DEVICE_ID

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/startcharge?deviceId=YOUR_DEVICE_ID' \
  -H 'apikey: {APIKEY}'

Pause Charging Session

Pauses the current charging session on the specified device.

Authorizations:

apiKeyAuth

query Parameters

deviceId

required

string

Example: deviceId=YOUR_DEVICE_ID

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/pausecharge?deviceId=YOUR_DEVICE_ID' \
  -H 'apikey: {APIKEY}'

Set Maximum Charging Current

Updates the maximum charging current (in Amperes) allowed for the session.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Example: value=16

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/intensity?deviceId=YOUR_DEVICE_ID&value=16' \
  -H 'apikey: {APIKEY}'

Lock/Unlock Charging Point

Locks or unlocks the charging point access. 0: Unlock, 1: Lock.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=DFL2JPV
value required	string Enum: "0" "1" Example: value=1

Responses

Request samples

cURL (Lock)
cURL (Unlock)

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/locked?deviceId=DFL2JPV&value=1' \
  -H 'apikey: {APIKEY}'

Activate/Deactivate Dynamic Power Control

Enables or disables dynamic power control (load balancing). 0: Dynamic Off, 1: Dynamic On.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Enum: "0" "1" Example: value=1

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/dynamic?deviceId=YOUR_DEVICE_ID&value=1' \
  -H 'apikey: {APIKEY}'

Configure Photovoltaic (PV) Charging Mode

Updates the photovoltaic charging mode. 0: PV + Minimum Power, 1: Exclusive PV, 2: Maximum Power.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Enum: "0" "1" "2" Example: value=1

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/chargefvmode?deviceId=YOUR_DEVICE_ID&value=1' \
  -H 'apikey: {APIKEY}'

Response samples

Content type

application/json

{"message": "Command executed successfully"
}

Set Maximum Installation Power (Watts)

Updates the maximum power (in Watts) allowed for the entire electrical installation.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Example: value=5750

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/maxpower?deviceId=YOUR_DEVICE_ID&value=5750' \
  -H 'apikey: {APIKEY}'

Set Vehicle Maximum Accepted Current

Updates the maximum charging current (in Amperes) that the connected electric vehicle (EV) can accept.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Example: value=32

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/max_car_int?deviceId=YOUR_DEVICE_ID&value=32' \
  -H 'apikey: {APIKEY}'

Set Vehicle Minimum Accepted Current

Updates the minimum charging current (in Amperes) that the connected electric vehicle (EV) requires to charge.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Example: value=6

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/min_car_int?deviceId=YOUR_DEVICE_ID&value=6' \
  -H 'apikey: {APIKEY}'

Program Charge by Energy (kWh)

Configures the device to automatically stop charging after a specific amount of energy (in kWh) has been delivered.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Example: value=10

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/charger_until_energy?deviceId=YOUR_DEVICE_ID&value=10' \
  -H 'apikey: {APIKEY}'

Program Charge by Time (Minutes)

Configures the device to automatically stop charging after a specific duration (in minutes).

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Example: value=60

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/charger_until_minutes?deviceId=YOUR_DEVICE_ID&value=60' \
  -H 'apikey: {APIKEY}'

Start Scheduled Charge by Energy (kWh)

Starts a charging session that is scheduled to stop after delivering a specified amount of energy (in kWh).

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
kw required	string Example: kw=15

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/startchargekw?deviceId=YOUR_DEVICE_ID&kw=15' \
  -H 'apikey: {APIKEY}'

Start Scheduled Charge by Time

Starts a charging session that is scheduled to stop after a specified number of minutes.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
minutes required	string Example: minutes=120

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/startchargeminutes?deviceId=YOUR_DEVICE_ID&minutes=120' \
  -H 'apikey: {APIKEY}'

Program Charging Timer

Configures a start/end time timer (timerId) on the device for scheduled charging.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
timer id required	string Example: timer id=1

Request Body schema: application/json
required

start_time	string <time>
end_time	string <time>
active	boolean

Responses

Request samples

Payload
cURL

Content type

application/json

{"start_time": "22:00",
"end_time": "06:00",
"active": true
}

Enable/Disable Third-Party API Control Mode

Enables or disables the device's control mode via the third-party API.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
mode required	string Example: mode=1
value required	string Example: value=1

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/thirdparty_mode?deviceId=YOUR_DEVICE_ID&mode=1&value=1' \
  -H 'apikey: {APIKEY}'

Set Installation Type

Updates the electrical installation type. 0: Monophase, 1: Three-phase, 2: Photovoltaic.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Enum: "0" "1" "2" Example: value=0

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/inst_type?deviceId=YOUR_DEVICE_ID&value=0' \
  -H 'apikey: {APIKEY}'

Enable/Disable OCPP Functionality

Activates or deactivates the Open Charge Point Protocol (OCPP) functionality. 0: OCPP Off, 1: OCPP On.

Authorizations:

apiKeyAuth

query Parameters

id required	string Example: id=YOUR_DEVICE_ID The device's ID
value required	string Enum: "0" "1" Example: value=1

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/ocpp?id=YOUR_DEVICE_ID&value=1' \
  -H 'apikey: {APIKEY}'

Configure OCPP Charge Point ID

Configures the unique Charge Point Identifier for OCPP communication.

Authorizations:

apiKeyAuth

query Parameters

id required	string Example: id=YOUR_DEVICE_ID The device's ID
value required	string Example: value=V2C_Charger_001

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/ocpp_id?id=YOUR_DEVICE_ID&value=V2C_Charger_001' \
  -H 'apikey: {APIKEY}'

Configure OCPP Server Address (URL)

Configures the endpoint URL for the central OCPP server.

Authorizations:

apiKeyAuth

query Parameters

id required	string Example: id=YOUR_DEVICE_ID The device's ID
value required	string Example: value=ws://ocpp.server.com/endpoint

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/ocpp_addr?id=YOUR_DEVICE_ID&value=ws%3A%2F%2Focpp.server.com%2Fendpoint' \
  -H 'apikey: {APIKEY}'

Set Denka Maximum Power

Updates the maximum power setting for Denka devices.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Example: value=5000

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/denka/max_power?deviceId=YOUR_DEVICE_ID&value=5000' \
  -H 'apikey: {APIKEY}'

Configure Inverter IP Address

Configures the IP address of the connected solar inverter (e.g., Huawei).

Authorizations:

apiKeyAuth

query Parameters

id required	string Example: id=YOUR_DEVICE_ID The device's ID
value required	string Example: value=192.168.1.100

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/inverter_ip?id=YOUR_DEVICE_ID&value=192.168.1.100' \
  -H 'apikey: {APIKEY}'

Configure Device WiFi Connection

Updates the device's WiFi network credentials (SSID and Password).

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
ssid required	string Example: ssid=MyWifiNetwork
password required	string Example: password=MyWifiPassword123

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/wifi?deviceId=YOUR_DEVICE_ID&ssid=MyWifiNetwork&password=MyWifiPassword123' \
  -H 'apikey: {APIKEY}'

Set Connected Meter (Slave) Type

Updates the connected energy meter (slave) type for load balancing. 0: Shelly, 1: V2C v2, 3: Huawei, 4: Solax, etc.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Example: value=3

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/slave_type?deviceId=YOUR_DEVICE_ID&value=3' \
  -H 'apikey: {APIKEY}'

Set Device Language

Changes the device's display language. Values include 0: English, 1: Spanish, 2: Portuguese, etc.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Enum: "0" "1" "2" "3" "4" "5" "6" Example: value=1

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/language?deviceId=YOUR_DEVICE_ID&value=1' \
  -H 'apikey: {APIKEY}'

Control Device Logo LED Status

Turns the device's logo LED light on or off.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Enum: "0" "1" Example: value=1

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/logo_led?deviceId=YOUR_DEVICE_ID&value=1' \
  -H 'apikey: {APIKEY}'

Reboot Device

Executes a remote reboot command on the device.

Authorizations:

apiKeyAuth

query Parameters

deviceId

required

string

Example: deviceId=YOUR_DEVICE_ID

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/reboot?deviceId=YOUR_DEVICE_ID' \
  -H 'apikey: {APIKEY}'

Device Status & Data Retrieval

Queries to obtain the current operational state and diagnostic data from the device (GET Queries).

Retrieve Current State Charge Data

Retrieves the device's comprehensive operational data, including charging status, power metrics, and error codes.

Authorizations:

apiKeyAuth

query Parameters

deviceId

required

string

Example: deviceId=YOUR_DEVICE_ID

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/thirdparty/device/currentstatecharge?deviceId=YOUR_DEVICE_ID' \
  -H 'apikey: {APIKEY}'

Response samples

Content type

application/json

Example

Trydan Device Data

{"error": "244",
"battery": "0.000000",
"voltage": "230.50",
"intensity": "6",
"seconds": "93",
"photovoltaic_on": "1",
"house_power": "3.500000",
"charge_state": "2",
"power": "1.380000",
"sun_power": "1.500000",
"phases": "1",
"cp_level": "248.000000",
"energy": "0.000000"
}

Retrieve Device Last Reported Status (Shadow)

Gets the last known status and data reported by the device (the "shadow" state). This is the most comprehensive data endpoint.

Authorizations:

apiKeyAuth

query Parameters

deviceId

required

string

Example: deviceId=YOUR_DEVICE_ID

Responses

Request samples

cURL

curl -X 'GET' \
  'https://v2c.cloud/kong/v2c_service/device/reported?deviceId=YOUR_DEVICE_ID' \
  -H 'apikey: {APIKEY}'

Check Device Connectivity Status

Checks if the device is currently connected to the V2C Cloud service.

Authorizations:

apiKeyAuth

query Parameters

deviceId

required

string

Example: deviceId=YOUR_DEVICE_ID

Responses

Request samples

cURL

curl -X 'GET' \
  'https://v2c.cloud/kong/v2c_service/device/connected?deviceId=YOUR_DEVICE_ID' \
  -H 'apikey: {APIKEY}'

Scan for Visible WiFi Networks

Sends a command to the device to scan and return a list of all visible WiFi networks in its vicinity.

Authorizations:

apiKeyAuth

query Parameters

required

string

Example: id=YOUR_DEVICE_ID

The device's ID

Responses

Request samples

cURL

curl -X 'GET' \
  'https://v2c.cloud/kong/v2c_service/device/wifilist?id=YOUR_DEVICE_ID' \
  -H 'apikey: {APIKEY}'

RFID Management

Administration of RFID cards, including registration, removal, and reader control.

Activate RFID Card Learning Mode

Puts the device into a learning state to read and register a new physical RFID card.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
tag required	string Example: tag=NewCardName

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/rfid?deviceId=YOUR_DEVICE_ID&tag=NewCardName' \
  -H 'apikey: {APIKEY}'

Delete Registered RFID Card by Code

Deletes an RFID card from the device's whitelist using its unique code (UID).

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
code required	string Example: code=RFID_UID_TO_DELETE

Responses

Request samples

cURL

curl -X 'DELETE' \
  'https://v2c.cloud/kong/v2c_service/device/rfid?deviceId=YOUR_DEVICE_ID&code=RFID_UID_TO_DELETE' \
  -H 'apikey: {APIKEY}'

Retrieve Registered RFID Cards

Gets the list of all RFID cards currently registered on the device.

Authorizations:

apiKeyAuth

query Parameters

deviceId

required

string

Example: deviceId=YOUR_DEVICE_ID

Responses

Request samples

cURL

curl -X 'GET' \
  'https://v2c.cloud/kong/v2c_service/device/rfid?deviceId=YOUR_DEVICE_ID' \
  -H 'apikey: {APIKEY}'

Manually Register RFID Card

Manually adds an RFID card to the device's whitelist by specifying its code (UID) and a name (tag).

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
code required	string Example: code=NEW_RFID_UID
tag required	string Example: tag=ManualCardName

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/rfid/tag?deviceId=YOUR_DEVICE_ID&code=NEW_RFID_UID&tag=ManualCardName' \
  -H 'apikey: {APIKEY}'

Update RFID Card Name (Tag)

Updates the friendly name (tag) associated with an existing registered RFID card code.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
code required	string Example: code=RFID_UID_TO_UPDATE
tag required	string Example: tag=UpdatedCardName

Responses

Request samples

cURL

curl -X 'PUT' \
  'https://v2c.cloud/kong/v2c_service/device/rfid/tag?deviceId=YOUR_DEVICE_ID&code=RFID_UID_TO_UPDATE&tag=UpdatedCardName' \
  -H 'apikey: {APIKEY}'

Enable/Disable RFID Reader

Activates or deactivates the physical RFID reader functionality on the device. 0: Reader Off, 1: Reader On.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
value required	string Enum: "0" "1" Example: value=1

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/set_rfid?deviceId=YOUR_DEVICE_ID&value=1' \
  -H 'apikey: {APIKEY}'

Charging Statistics

Retrieval of aggregated and session-specific data for charging history.

Retrieve Charging Statistics by Device

Gets the last 5 charging statistics for a specific device, with optional filtering by date range.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID
chargeDateStart	string <date> Example: chargeDateStart=2023-01-01
chargeDateEnd	string <date> Example: chargeDateEnd=2023-01-31

Responses

Request samples

cURL (No Dates)
cURL (With Dates)

curl -X 'GET' \
  'https://v2c.cloud/kong/v2c_service/stadistic/device?deviceId=YOUR_DEVICE_ID' \
  -H 'apikey: {APIKEY}'

Response samples

Content type

application/json

[{"id": 17307150,
"deviceId": "QRPW7LV",
"startChargeDate": "2025-10-28T11:44:47",
"endChargeDate": "2025-10-28T14:45:05",
"idCharge": "2025-10-28 11:44:47",
"energy": 9.6,
"cost": 1.44,
"coCost": 2.976,
"costFv": 0,
"energyByHour": "0.9|3.5|3.6|1.6",
"energyByHourFv": null,
"rfidCode": "aa23b601",
"rfidName": "Vicente",
"message": null,
"warning": false,
"finished": true,
"createdAt": "2025-10-28T10:44:52.000+00:00",
"updatedAt": "2025-10-28T13:45:07.000+00:00"
}
]

Retrieve Global Charging Statistics

Gets aggregated (global) charging statistics for all devices associated with the authenticated user, optionally filtered by date range.

Authorizations:

apiKeyAuth

query Parameters

endChargeDateStart	string <date> Example: endChargeDateStart=2023-01-01
endChargeDateEnd	string <date> Example: endChargeDateEnd=2023-01-31

Responses

Request samples

cURL

curl -X 'GET' \
  'https://v2c.cloud/kong/v2c_service/stadistic/global/me?endChargeDateStart=2023-01-01&endChargeDateEnd=2023-01-31' \
  -H 'apikey: {APIKEY}'

Response samples

Content type

application/json

[{"totalEnergy": 1500.75,
"totalCharges": 120
}
]

Advanced Power Profiles

Management of personalized power configurations (e.g., Solar Mode profiles).

Save New Advanced Power Profile (v2)

Creates and saves a new personalized power configuration profile.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID The device's ID
name required	string Example: name=SolarMode The profile name
updateAt required	string Example: updateAt=2023-10-27T10:00:00Z The time when sent (for versioning/timestamping)

Request Body schema: application/json
required

mode	string
value	integer

Responses

Request samples

Payload
cURL

Content type

application/json

{"mode": "solar",
"value": 32
}

Update Existing Advanced Power Profile (v2)

Updates an existing personalized power configuration profile.

Authorizations:

apiKeyAuth

query Parameters

id required	string Example: id=YOUR_DEVICE_ID The device's ID
name required	string Example: name=SolarMode The profile name
updateAt required	string Example: updateAt=2023-10-27T10:01:00Z The time when sent (for versioning/timestamping)

Request Body schema: application/json
required

mode	string
value	integer

Responses

Request samples

Payload
cURL

Content type

application/json

{"mode": "solar",
"value": 32
}

Retrieve Specific Advanced Power Profile (v2)

Retrieves a single personalized power configuration profile using its timestamp.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID The device's ID
updateAt required	string Example: updateAt=2023-10-27T10:00:00Z The profile timestamp

Responses

Request samples

cURL

curl -X 'GET' \
  'https://v2c.cloud/kong/v2c_service/device/personalicepower/v2?deviceId=YOUR_DEVICE_ID&updateAt=2023-10-27T10:00:00Z' \
  -H 'apikey: {APIKEY}'

Delete Advanced Power Profile (v2)

Deletes a personalized power configuration profile by its name and timestamp.

Authorizations:

apiKeyAuth

query Parameters

deviceId required	string Example: deviceId=YOUR_DEVICE_ID The device's ID
name required	string Example: name=SolarMode The personalice power name
updateAt required	string Example: updateAt=2023-10-27T10:00:00Z The profile timestamp

Responses

Request samples

cURL

curl -X 'DELETE' \
  'https://v2c.cloud/kong/v2c_service/device/personalicepower/v2?deviceId=YOUR_DEVICE_ID&name=SolarMode&updateAt=2023-10-27T10:00:00Z' \
  -H 'apikey: {APIKEY}'

Retrieve All Advanced Power Profiles

Gets a list of all personalized power configuration profiles associated with the device.

Authorizations:

apiKeyAuth

query Parameters

deviceId

required

string

Example: deviceId=YOUR_DEVICE_ID

The device's ID

Responses

Request samples

cURL

curl -X 'GET' \
  'https://v2c.cloud/kong/v2c_service/device/personalicepower/all?deviceId=YOUR_DEVICE_ID' \
  -H 'apikey: {APIKEY}'

Firmware Management

Management and query of the device's firmware version.

Initiate Firmware Update

Sends a command to the device to search for and install the latest available firmware update.

Authorizations:

apiKeyAuth

query Parameters

deviceId

required

string

Example: deviceId=YOUR_DEVICE_ID

Responses

Request samples

cURL

curl -X 'POST' \
  'https://v2c.cloud/kong/v2c_service/device/update?deviceId=YOUR_DEVICE_ID' \
  -H 'apikey: {APIKEY}'

Retrieve Device Firmware Version

Gets the current firmware version string of the specified device.

Authorizations:

apiKeyAuth

query Parameters

deviceId

required

string

Example: deviceId=YOUR_DEVICE_ID

Responses

Request samples

cURL

curl -X 'GET' \
  'https://v2c.cloud/kong/v2c_service/version?deviceId=YOUR_DEVICE_ID' \
  -H 'apikey: {APIKEY}'

Pairing Management

Management of device pairings associated with the user account.

Retrieve All User Pairings

Gets the list of all device pairings associated with the authenticated user.

Authorizations:

apiKeyAuth

Responses

Request samples

cURL

curl -X 'GET' \
  'https://v2c.cloud/kong/v2c_service/pairings/me' \
  -H 'apikey: {APIKEY}'

Response samples

Content type

application/json

[{"id": "pairing_id_123",
"name": "My Pairing"
}
]

V2C Thirdparty API (1.0.0)

Introduction

Authentication

How to obtain your API Key

Rate Limiting

Device Control & Configuration

Start or Resume Charging Session

Authorizations:

query Parameters

Responses

Request samples

Pause Charging Session

Authorizations:

query Parameters

Responses

Request samples

Set Maximum Charging Current

Authorizations:

query Parameters

Responses

Request samples

Lock/Unlock Charging Point

Authorizations:

query Parameters

Responses

Request samples

Activate/Deactivate Dynamic Power Control

Authorizations:

query Parameters

Responses

Request samples

Configure Photovoltaic (PV) Charging Mode

Authorizations:

query Parameters

Responses

Request samples

Response samples

Set Maximum Installation Power (Watts)

Authorizations:

query Parameters

Responses

Request samples

Set Vehicle Maximum Accepted Current

Authorizations:

query Parameters

Responses

Request samples

Set Vehicle Minimum Accepted Current

Authorizations:

query Parameters

Responses

Request samples

Program Charge by Energy (kWh)

Authorizations:

query Parameters

Responses

Request samples

Program Charge by Time (Minutes)

Authorizations:

query Parameters

Responses

Request samples

Start Scheduled Charge by Energy (kWh)

Authorizations:

query Parameters

Responses

Request samples

Start Scheduled Charge by Time

Authorizations:

query Parameters

Responses

Request samples

Program Charging Timer

Authorizations:

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Enable/Disable Third-Party API Control Mode

Authorizations:

Request Body schema: application/json
required