Meters / Create

POST

api

assets

meters

Meters / Create

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

Scopes

asset:meters

Headers

Accept-Language

string

BCP 47 language tag for content negotiation (e.g. en, de-DE).

Example:

"en"

Body

application/json

Creates a meter and attaches it to a chargepoint of the authenticated client. Required permission: asset:meters:create. Available contexts: API Key, User.

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

Public key used to verify calibration-law-relevant meter value signatures.

Maximum string length: 255

installation_date

string<date>

Date the meter was physically installed.

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

market_partner

string

Name of the energy market partner responsible for the meter, typically the grid operator or metering service provider. Used in EDI/GPKE communication.

Maximum string length: 100

meter_type

string

Human-readable meter type label (e.g. "Smart Meter mit Fernuebertragung"). Determines how meter readings are processed and whether they qualify for legally compliant billing.

meter_serial_number

string

Serial number reported by the physical meter (counter number).

Maximum string length: 70

meter_point

string

Metering point identifier (Marktlokations- or Messlokations-ID).

Maximum string length: 50

comment

string

Free-form internal note, visible only to back-office users.

Maximum string length: 255

active

boolean

default:false

Whether the meter is in service. Inactive meters are excluded from billing. Only one meter per charging point can be active at a time.

internal_counter

boolean

default:false

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

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

sum_counter

boolean

default:false

Whether this meter aggregates readings across multiple charging points or sessions.

is_public

boolean

default:false

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

serial_number

string

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

Manufacturer article (model) number.

Maximum string length: 16

manufacturer

string

Name of the meter manufacturer.

Maximum string length: 32

Response

Created meter.

meter

object

required

The meter record with its location, station and charge point assignment and its counter readings.

Show child attributes

⌘I

Meters / Create

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>"
}

Getting started - Core

Core API

Authorizations

Scopes

Headers

Body

Response