customers
Get v3customers contracts product info
The Product info shows periods with unique prices for all contract’s products in a requested time period. The periods are made up of the shortest possible validity periods between ProductItems and CostItems connected to the Product.
The requested start/end times are restricted as follows:
- start_date
- must be before end_date
- if not supplied, defaults to the order_date of the contract
- end_date
- the earliest of either the requested time, delivery_end or today (as there may be a price change tomorrow that is not yet known)
GET
/
v3
/
customers
/
{customer_id}
/
contracts
/
{contract_id}
/
product_info
/
cURL
curl --request GET \
--url https://api.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/import requests
url = "https://api.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/', 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.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"contract_id": "<string>",
"customer_id": "<string>",
"product_infos": [
{
"product_name": "<string>",
"display_name": "<string>",
"minimum_contract_term": 123,
"contract_notice_period": 123,
"contract_notice_period_unit": "<string>",
"product_valid_from": "2023-12-25",
"periods": [
{
"period_start": "2023-12-25",
"product_items": [
{
"valid_from": "2023-12-25",
"unit": "ct/kWh",
"amount_gross": 123,
"amount_net": 123,
"classification": "<string>",
"display_name": "<string>",
"associated_costs": [
{
"name": "<string>",
"unit": "ct/kWh",
"valid_from": "2023-12-25",
"cost_per_unit_net": 123,
"cost_per_unit_gross": 123,
"display_name": "<string>",
"valid_until": "2023-12-25"
}
],
"internal_name": "<string>",
"valid_until": "2023-12-25"
}
],
"totals": [
{
"total_price_net": 123,
"total_price_gross": 123,
"unit": "ct/kWh"
}
],
"variable_costs": [
{
"cost_type": "<string>",
"unit": "ct/kWh",
"valid_from": "2023-12-25",
"name": "<string>",
"display_name": "<string>",
"valid_until": "2023-12-25",
"value": 0,
"explanation": "<string>"
}
],
"period_end": "2023-12-25"
}
],
"product_valid_until": "2023-12-25"
}
]
}Response
The Product info shows periods with unique prices for a contract's product und a requested time period. The periods are made up of the shortest possible validity periods between ProductItems and CostItems connected to the Product.
Contract ID of the contract that the product belongs to.
Customer ID of the customer that the product belongs to.
List of Product Info instances. One per product that has been active in the requested time range.
Show child attributes
Show child attributes
⌘I
cURL
curl --request GET \
--url https://api.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/import requests
url = "https://api.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/', 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.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lumenaza.de/v3/customers/{customer_id}/contracts/{contract_id}/product_info/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"contract_id": "<string>",
"customer_id": "<string>",
"product_infos": [
{
"product_name": "<string>",
"display_name": "<string>",
"minimum_contract_term": 123,
"contract_notice_period": 123,
"contract_notice_period_unit": "<string>",
"product_valid_from": "2023-12-25",
"periods": [
{
"period_start": "2023-12-25",
"product_items": [
{
"valid_from": "2023-12-25",
"unit": "ct/kWh",
"amount_gross": 123,
"amount_net": 123,
"classification": "<string>",
"display_name": "<string>",
"associated_costs": [
{
"name": "<string>",
"unit": "ct/kWh",
"valid_from": "2023-12-25",
"cost_per_unit_net": 123,
"cost_per_unit_gross": 123,
"display_name": "<string>",
"valid_until": "2023-12-25"
}
],
"internal_name": "<string>",
"valid_until": "2023-12-25"
}
],
"totals": [
{
"total_price_net": 123,
"total_price_gross": 123,
"unit": "ct/kWh"
}
],
"variable_costs": [
{
"cost_type": "<string>",
"unit": "ct/kWh",
"valid_from": "2023-12-25",
"name": "<string>",
"display_name": "<string>",
"valid_until": "2023-12-25",
"value": 0,
"explanation": "<string>"
}
],
"period_end": "2023-12-25"
}
],
"product_valid_until": "2023-12-25"
}
]
}
