Contract Monthly Cost Details

GET

partner

customers

{customerNumber}

contracts

{contractNumber}

costs

Get most recent contract fees and cost components

curl --request GET \
  --url https://api.rabot-charge.de/partner/v1/customers/{customerNumber}/contracts/{contractNumber}/costs \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.rabot-charge.de/partner/v1/customers/{customerNumber}/contracts/{contractNumber}/costs"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.rabot-charge.de/partner/v1/customers/{customerNumber}/contracts/{contractNumber}/costs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "isSuccess": true,
  "message": null,
  "error": [
    {
      "severity": "Error",
      "code": "validation-failed",
      "message": "First name is required for non-business customers.",
      "details": null
    }
  ],
  "refUri": "<string>",
  "data": [
    {
      "validFrom": "2023-11-07T05:31:56Z",
      "baseServiceFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "variableServiceFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "baseGridFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "variableGridFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "meteringFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "expectedEnergyCost": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "guaranteeOfOrigin": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "concessionFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "kwkgFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "electricityTax": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "savingsShare": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "estimatedConsumption": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "offshoreFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "p19Fee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "exchangeFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "savingToComparisonTariff": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "amountKind": "Gross"
    }
  ],
  "count": 10,
  "hasMoreItems": true
}

Use this endpoint to retrieve detailed information about the cost components applicable for a specific contract. This allows your application to show a cost breakdown to the end user, providing insight about which costs are related to grid fees and other taxes and levies, and which costs are related to the cost of energy procurement. This endpoint provides the data of the most recent month breakdown, i.e. a snapshot of the cost components on an invoice.

Requires role:application scope or Linked relation on customer level.

The API provides cost / price information on the following components:

Component	Description
`baseServiceFee`	monthly service fee
`variableServiceFee`	per kWh service fee
`baseGridFee`	monthly grid fees, defined by the local grid operator (DSO)
`variableGridFee`	per kWh grid fees, defined by the local grid operator (DSO)
`meteringFee`	monthly metering cost, defined by the metering operator
`expectedEnergyCost`	the expected cost per kWh on the EPEX Day-Ahead market, for the next month
`exchangeFee`	Energy market fee
`guaranteeOfOrigin`	the cost per kWh for the guarantee of origin for renewable energy
`concessionFee`	concession fee (per kWh) as defined by the local municipality
`kwkgFee`	applicable fee according to the German Heat-and-power Cogeneration Act (KWKG)
`electricityTax`	German electricity tax
`offshoreFee`	Offshore fee
`p19Fee`	Special grid usage / §19 StromNEV fee

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

customerNumber

string

required

Customer number

contractNumber

string

required

Contract number

Response

200 - application/json

API response DTO with a list of items.

isSuccess

boolean

read-only

Success status of the operation based on status code (2xx range).

Example:

true

message

string | null

Optional message to provide additional information about the operation result.

Example:

null

error

object[] | null

Optional error details in case of an error(s).

Hide child attributes

error.severity

enum<string>

Severity of the error.

Available options:

Error,

Warning,

Notice

Example:

"Error"

error.code

string

Internal error code for client processing.

Example:

"validation-failed"

error.message

string

Error message.

Example:

"First name is required for non-business customers."

error.details

string | null

Additional details about the error.

Example:

null

refUri

string<uri> | null

read-only

Optional reference URI to point to the resulting resource.

data

object[]

Returned data instance.

Hide child attributes

data.validFrom

string<date-time>

required

The date and time from which the cost components are valid.

data.baseServiceFee

object

required

The base service fee component.

Hide child attributes

data.baseServiceFee.value

number<double>

Value of the unit.

data.baseServiceFee.unit

object

Unit of the value.

Hide child attributes

data.baseServiceFee.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.baseServiceFee.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.baseServiceFee.unitText

string

Textual representation of the unit in German.

data.variableServiceFee

object

required

The variable service fee component.

Hide child attributes

data.variableServiceFee.value

number<double>

Value of the unit.

data.variableServiceFee.unit

object

Unit of the value.

Hide child attributes

data.variableServiceFee.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.variableServiceFee.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.variableServiceFee.unitText

string

Textual representation of the unit in German.

data.baseGridFee

object

required

The base grid fee component.

Hide child attributes

data.baseGridFee.value

number<double>

Value of the unit.

data.baseGridFee.unit

object

Unit of the value.

Hide child attributes

data.baseGridFee.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.baseGridFee.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.baseGridFee.unitText

string

Textual representation of the unit in German.

data.variableGridFee

object

required

The variable grid fee component.

Hide child attributes

data.variableGridFee.value

number<double>

Value of the unit.

data.variableGridFee.unit

object

Unit of the value.

Hide child attributes

data.variableGridFee.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.variableGridFee.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.variableGridFee.unitText

string

Textual representation of the unit in German.

data.meteringFee

object

required

The metering fee component.

Hide child attributes

data.meteringFee.value

number<double>

Value of the unit.

data.meteringFee.unit

object

Unit of the value.

Hide child attributes

data.meteringFee.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.meteringFee.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.meteringFee.unitText

string

Textual representation of the unit in German.

data.expectedEnergyCost

object

required

The expected energy cost component.

Hide child attributes

data.expectedEnergyCost.value

number<double>

Value of the unit.

data.expectedEnergyCost.unit

object

Unit of the value.

Hide child attributes

data.expectedEnergyCost.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.expectedEnergyCost.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.expectedEnergyCost.unitText

string

Textual representation of the unit in German.

data.guaranteeOfOrigin

object

required

The guarantees of origin fee component.

Hide child attributes

data.guaranteeOfOrigin.value

number<double>

Value of the unit.

data.guaranteeOfOrigin.unit

object

Unit of the value.

Hide child attributes

data.guaranteeOfOrigin.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.guaranteeOfOrigin.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.guaranteeOfOrigin.unitText

string

Textual representation of the unit in German.

data.concessionFee

object

required

The concession fee component.

Hide child attributes

data.concessionFee.value

number<double>

Value of the unit.

data.concessionFee.unit

object

Unit of the value.

Hide child attributes

data.concessionFee.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.concessionFee.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.concessionFee.unitText

string

Textual representation of the unit in German.

data.kwkgFee

object

required

The KWKG (Combined Heat and Power Act) fee component.

Hide child attributes

data.kwkgFee.value

number<double>

Value of the unit.

data.kwkgFee.unit

object

Unit of the value.

Hide child attributes

data.kwkgFee.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.kwkgFee.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.kwkgFee.unitText

string

Textual representation of the unit in German.

data.electricityTax

object

required

The electricity tax component.

Hide child attributes

data.electricityTax.value

number<double>

Value of the unit.

data.electricityTax.unit

object

Unit of the value.

Hide child attributes

data.electricityTax.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.electricityTax.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.electricityTax.unitText

string

Textual representation of the unit in German.

The savings share component.

Hide child attributes

Value of the unit.

Unit of the value.

Hide child attributes

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

Textual representation of the unit in German.

data.estimatedConsumption

object

required

The estimated consumption value.

Hide child attributes

data.estimatedConsumption.value

number<double>

Value of the unit.

data.estimatedConsumption.unit

object

Unit of the value.

Hide child attributes

data.estimatedConsumption.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.estimatedConsumption.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.estimatedConsumption.unitText

string

Textual representation of the unit in German.

data.offshoreFee

object

required

The offshore fee component.

Hide child attributes

data.offshoreFee.value

number<double>

Value of the unit.

data.offshoreFee.unit

object

Unit of the value.

Hide child attributes

data.offshoreFee.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.offshoreFee.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.offshoreFee.unitText

string

Textual representation of the unit in German.

data.p19Fee

object

required

The §19 StromNEV (P19) fee component.

Hide child attributes

data.p19Fee.value

number<double>

Value of the unit.

data.p19Fee.unit

object

Unit of the value.

Hide child attributes

data.p19Fee.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.p19Fee.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.p19Fee.unitText

string

Textual representation of the unit in German.

data.exchangeFee

object

required

The exchange fee component.

Hide child attributes

data.exchangeFee.value

number<double>

Value of the unit.

data.exchangeFee.unit

object

Unit of the value.

Hide child attributes

data.exchangeFee.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.exchangeFee.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.exchangeFee.unitText

string

Textual representation of the unit in German.

data.savingToComparisonTariff

object

required

The savings compared to a comparison tariff.

Hide child attributes

data.savingToComparisonTariff.value

number<double>

Value of the unit.

data.savingToComparisonTariff.unit

object

Unit of the value.

Hide child attributes

data.savingToComparisonTariff.unit.main

enum<string>

Main unit.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.savingToComparisonTariff.unit.per

enum<string> | null

Per unit in form of main/per or NULL if none.

Available options:

None,

Kwh,

Kw,

Euro,

Cent,

Percent,

Year,

Month,

Day,

Hour,

Minute

data.savingToComparisonTariff.unitText

string

Textual representation of the unit in German.

data.amountKind

enum<string>

The kind of amount that is represented by these cost components.

Available options:

Gross,

Net

count

integer<int32>

read-only

Number of items returned in the list.

Example:

10

hasMoreItems

boolean

Indicates, whether there are more items to be returned in the list, that are not included in the limit of this request.

Example:

true

⌘I

Get most recent contract fees and cost components

curl --request GET \
  --url https://api.rabot-charge.de/partner/v1/customers/{customerNumber}/contracts/{contractNumber}/costs \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.rabot-charge.de/partner/v1/customers/{customerNumber}/contracts/{contractNumber}/costs"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.rabot-charge.de/partner/v1/customers/{customerNumber}/contracts/{contractNumber}/costs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "isSuccess": true,
  "message": null,
  "error": [
    {
      "severity": "Error",
      "code": "validation-failed",
      "message": "First name is required for non-business customers.",
      "details": null
    }
  ],
  "refUri": "<string>",
  "data": [
    {
      "validFrom": "2023-11-07T05:31:56Z",
      "baseServiceFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "variableServiceFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "baseGridFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "variableGridFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "meteringFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "expectedEnergyCost": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "guaranteeOfOrigin": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "concessionFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "kwkgFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "electricityTax": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "savingsShare": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "estimatedConsumption": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "offshoreFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "p19Fee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "exchangeFee": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "savingToComparisonTariff": {
        "value": 123,
        "unit": {
          "main": "None",
          "per": "None"
        },
        "unitText": "<string>"
      },
      "amountKind": "Gross"
    }
  ],
  "count": 10,
  "hasMoreItems": true
}

Introduction

Get Started

Quickstart

Guides

Updates

API reference

Authorizations

Path Parameters

Response