Creates a meter

Creates a meter

curl --request POST \
  --url https://api.chargecloud.dev/api/v1/assets/meters \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chargepoint_uuid": "<string>",
  "public_key": "<string>",
  "installation_date": "2023-12-25",
  "market_partner": "<string>",
  "meter_type": "<string>",
  "meter_serial_number": "<string>",
  "meter_point": "<string>",
  "comment": "<string>",
  "active": false,
  "internal_counter": false,
  "credit_counter": false,
  "sum_counter": false,
  "is_public": false,
  "serial_number": "<string>",
  "article_number": "<string>",
  "manufacturer": "<string>"
}
'

import requests

url = "https://api.chargecloud.dev/api/v1/assets/meters"

payload = {
    "chargepoint_uuid": "<string>",
    "public_key": "<string>",
    "installation_date": "2023-12-25",
    "market_partner": "<string>",
    "meter_type": "<string>",
    "meter_serial_number": "<string>",
    "meter_point": "<string>",
    "comment": "<string>",
    "active": False,
    "internal_counter": False,
    "credit_counter": False,
    "sum_counter": False,
    "is_public": False,
    "serial_number": "<string>",
    "article_number": "<string>",
    "manufacturer": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    chargepoint_uuid: '<string>',
    public_key: '<string>',
    installation_date: '2023-12-25',
    market_partner: '<string>',
    meter_type: '<string>',
    meter_serial_number: '<string>',
    meter_point: '<string>',
    comment: '<string>',
    active: false,
    internal_counter: false,
    credit_counter: false,
    sum_counter: false,
    is_public: false,
    serial_number: '<string>',
    article_number: '<string>',
    manufacturer: '<string>'
  })
};

fetch('https://api.chargecloud.dev/api/v1/assets/meters', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.chargecloud.dev/api/v1/assets/meters",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'chargepoint_uuid' => '<string>',
    'public_key' => '<string>',
    'installation_date' => '2023-12-25',
    'market_partner' => '<string>',
    'meter_type' => '<string>',
    'meter_serial_number' => '<string>',
    'meter_point' => '<string>',
    'comment' => '<string>',
    'active' => false,
    'internal_counter' => false,
    'credit_counter' => false,
    'sum_counter' => false,
    'is_public' => false,
    'serial_number' => '<string>',
    'article_number' => '<string>',
    'manufacturer' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.chargecloud.dev/api/v1/assets/meters"

	payload := strings.NewReader("{\n  \"chargepoint_uuid\": \"<string>\",\n  \"public_key\": \"<string>\",\n  \"installation_date\": \"2023-12-25\",\n  \"market_partner\": \"<string>\",\n  \"meter_type\": \"<string>\",\n  \"meter_serial_number\": \"<string>\",\n  \"meter_point\": \"<string>\",\n  \"comment\": \"<string>\",\n  \"active\": false,\n  \"internal_counter\": false,\n  \"credit_counter\": false,\n  \"sum_counter\": false,\n  \"is_public\": false,\n  \"serial_number\": \"<string>\",\n  \"article_number\": \"<string>\",\n  \"manufacturer\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.chargecloud.dev/api/v1/assets/meters")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chargepoint_uuid\": \"<string>\",\n  \"public_key\": \"<string>\",\n  \"installation_date\": \"2023-12-25\",\n  \"market_partner\": \"<string>\",\n  \"meter_type\": \"<string>\",\n  \"meter_serial_number\": \"<string>\",\n  \"meter_point\": \"<string>\",\n  \"comment\": \"<string>\",\n  \"active\": false,\n  \"internal_counter\": false,\n  \"credit_counter\": false,\n  \"sum_counter\": false,\n  \"is_public\": false,\n  \"serial_number\": \"<string>\",\n  \"article_number\": \"<string>\",\n  \"manufacturer\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.chargecloud.dev/api/v1/assets/meters")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chargepoint_uuid\": \"<string>\",\n  \"public_key\": \"<string>\",\n  \"installation_date\": \"2023-12-25\",\n  \"market_partner\": \"<string>\",\n  \"meter_type\": \"<string>\",\n  \"meter_serial_number\": \"<string>\",\n  \"meter_point\": \"<string>\",\n  \"comment\": \"<string>\",\n  \"active\": false,\n  \"internal_counter\": false,\n  \"credit_counter\": false,\n  \"sum_counter\": false,\n  \"is_public\": false,\n  \"serial_number\": \"<string>\",\n  \"article_number\": \"<string>\",\n  \"manufacturer\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "meter": {
    "uuid": "<string>",
    "created_at": "2023-12-25",
    "updated_at": "2023-12-25",
    "modification_date": "2023-12-25",
    "chargepoint_uuid": "<string>",
    "public_key": "<string>",
    "location_uuid": "<string>",
    "station_uuid": "<string>",
    "installation_date": "2023-12-25",
    "market_partner": "<string>",
    "meter_type": "<string>",
    "meter_serial_number": "<string>",
    "meter_point": "<string>",
    "comment": "<string>",
    "active": false,
    "internal_counter": false,
    "credit_counter": false,
    "sum_counter": false,
    "is_public": false,
    "serial_number": "<string>",
    "article_number": "<string>",
    "manufacturer": "<string>"
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "errors": [
    {
      "errorKey": "<string>",
      "message": "<string>",
      "parameter": "<string>"
    }
  ]
}

{
  "error": "<string>"
}

POST

api

assets

meters

Creates a meter

curl --request POST \
  --url https://api.chargecloud.dev/api/v1/assets/meters \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chargepoint_uuid": "<string>",
  "public_key": "<string>",
  "installation_date": "2023-12-25",
  "market_partner": "<string>",
  "meter_type": "<string>",
  "meter_serial_number": "<string>",
  "meter_point": "<string>",
  "comment": "<string>",
  "active": false,
  "internal_counter": false,
  "credit_counter": false,
  "sum_counter": false,
  "is_public": false,
  "serial_number": "<string>",
  "article_number": "<string>",
  "manufacturer": "<string>"
}
'

import requests

url = "https://api.chargecloud.dev/api/v1/assets/meters"

payload = {
    "chargepoint_uuid": "<string>",
    "public_key": "<string>",
    "installation_date": "2023-12-25",
    "market_partner": "<string>",
    "meter_type": "<string>",
    "meter_serial_number": "<string>",
    "meter_point": "<string>",
    "comment": "<string>",
    "active": False,
    "internal_counter": False,
    "credit_counter": False,
    "sum_counter": False,
    "is_public": False,
    "serial_number": "<string>",
    "article_number": "<string>",
    "manufacturer": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    chargepoint_uuid: '<string>',
    public_key: '<string>',
    installation_date: '2023-12-25',
    market_partner: '<string>',
    meter_type: '<string>',
    meter_serial_number: '<string>',
    meter_point: '<string>',
    comment: '<string>',
    active: false,
    internal_counter: false,
    credit_counter: false,
    sum_counter: false,
    is_public: false,
    serial_number: '<string>',
    article_number: '<string>',
    manufacturer: '<string>'
  })
};

fetch('https://api.chargecloud.dev/api/v1/assets/meters', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.chargecloud.dev/api/v1/assets/meters",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'chargepoint_uuid' => '<string>',
    'public_key' => '<string>',
    'installation_date' => '2023-12-25',
    'market_partner' => '<string>',
    'meter_type' => '<string>',
    'meter_serial_number' => '<string>',
    'meter_point' => '<string>',
    'comment' => '<string>',
    'active' => false,
    'internal_counter' => false,
    'credit_counter' => false,
    'sum_counter' => false,
    'is_public' => false,
    'serial_number' => '<string>',
    'article_number' => '<string>',
    'manufacturer' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.chargecloud.dev/api/v1/assets/meters"

	payload := strings.NewReader("{\n  \"chargepoint_uuid\": \"<string>\",\n  \"public_key\": \"<string>\",\n  \"installation_date\": \"2023-12-25\",\n  \"market_partner\": \"<string>\",\n  \"meter_type\": \"<string>\",\n  \"meter_serial_number\": \"<string>\",\n  \"meter_point\": \"<string>\",\n  \"comment\": \"<string>\",\n  \"active\": false,\n  \"internal_counter\": false,\n  \"credit_counter\": false,\n  \"sum_counter\": false,\n  \"is_public\": false,\n  \"serial_number\": \"<string>\",\n  \"article_number\": \"<string>\",\n  \"manufacturer\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.chargecloud.dev/api/v1/assets/meters")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chargepoint_uuid\": \"<string>\",\n  \"public_key\": \"<string>\",\n  \"installation_date\": \"2023-12-25\",\n  \"market_partner\": \"<string>\",\n  \"meter_type\": \"<string>\",\n  \"meter_serial_number\": \"<string>\",\n  \"meter_point\": \"<string>\",\n  \"comment\": \"<string>\",\n  \"active\": false,\n  \"internal_counter\": false,\n  \"credit_counter\": false,\n  \"sum_counter\": false,\n  \"is_public\": false,\n  \"serial_number\": \"<string>\",\n  \"article_number\": \"<string>\",\n  \"manufacturer\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.chargecloud.dev/api/v1/assets/meters")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chargepoint_uuid\": \"<string>\",\n  \"public_key\": \"<string>\",\n  \"installation_date\": \"2023-12-25\",\n  \"market_partner\": \"<string>\",\n  \"meter_type\": \"<string>\",\n  \"meter_serial_number\": \"<string>\",\n  \"meter_point\": \"<string>\",\n  \"comment\": \"<string>\",\n  \"active\": false,\n  \"internal_counter\": false,\n  \"credit_counter\": false,\n  \"sum_counter\": false,\n  \"is_public\": false,\n  \"serial_number\": \"<string>\",\n  \"article_number\": \"<string>\",\n  \"manufacturer\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "meter": {
    "uuid": "<string>",
    "created_at": "2023-12-25",
    "updated_at": "2023-12-25",
    "modification_date": "2023-12-25",
    "chargepoint_uuid": "<string>",
    "public_key": "<string>",
    "location_uuid": "<string>",
    "station_uuid": "<string>",
    "installation_date": "2023-12-25",
    "market_partner": "<string>",
    "meter_type": "<string>",
    "meter_serial_number": "<string>",
    "meter_point": "<string>",
    "comment": "<string>",
    "active": false,
    "internal_counter": false,
    "credit_counter": false,
    "sum_counter": false,
    "is_public": false,
    "serial_number": "<string>",
    "article_number": "<string>",
    "manufacturer": "<string>"
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "errors": [
    {
      "errorKey": "<string>",
      "message": "<string>",
      "parameter": "<string>"
    }
  ]
}

{
  "error": "<string>"
}

Authorizations

Authorization

string

header

required

OAuth2 Bearer Authorization

Body

application/json

Creates a meter. Required permission: asset:meters:create

chargepoint_uuid

string

required

The UUID of the charge point this meter is assigned to. Each active meter must be linked to exactly one chargepoint. Only one active meter per charge point is allowed at a time.

Pattern: ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$

public_key

string

required

The cryptographic public key of the meter, used to verify the digital signatures on calibration-law-compliant meter readings.

Maximum string length: 255

installation_date

string<date>

The date the meter was physically installed at the chargepoint.

Pattern: ^\d{4}-\d{2}-\d{2}$

market_partner

string

The name of the energy market partner responsible for this meter, typically the grid operator or metering service provider.

Maximum string length: 100

meter_type

string

The technical type classification of the meter. Determines how meter readings are processed and whether they qualify for legally compliant billing.

meter_serial_number

string

The official serial number of the physical meter, as printed on the meter itself or provided by the manufacturer.

Maximum string length: 70

meter_point

string

The metering point identifier assigned by the grid operator.

Maximum string length: 50

comment

string

A free-text comment for internal notes about this meter. Not visible in any public-facing output. Used for operational remarks or installation notes.

Maximum string length: 255

active

boolean

default:false

Indicates whether this meter is currently active for the assigned chargepoint. Only one meter per chargepoint can be active at a time.

internal_counter

boolean

default:false

Indicates whether this meter is an internal software counter rather than a physical hardware meter. Internal counters are used when no certified physical meter is present.

credit_counter

boolean

default:false

Indicates whether this meter is used as a credit counter, tracking energy consumed against a prepaid or credit-based balance.

sum_counter

boolean

default:false

Indicates whether this meter functions as a cumulative sum counter, aggregating readings across multiple chargepoints or sessions.

is_public

boolean

default:false

Indicates whether this meter is physically visible and accessible to end customers at the charging station.

serial_number

string

The internal asset serial number of the meter hardware, used for inventory and spare parts management. May differ from meter_serial_number, which is the official calibration-relevant identifier.

Maximum string length: 16

article_number

string

The manufacturer's article or part number for this meter model.

Maximum string length: 16

manufacturer

string

The name of the meter hardware manufacturer.

Maximum string length: 32

Response

Meter created

meter

object

required

Meter

Show child attributes

Getting started - Core

Core API

Authorizations

Body

Response