Skip to main content
GET
/
partner
/
v1
/
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>'
{
  "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": {},
        "unitText": "<string>"
      },
      "variableServiceFee": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "baseGridFee": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "variableGridFee": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "meteringFee": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "expectedEnergyCost": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "guaranteeOfOrigin": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "concessionFee": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "kwkgFee": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "electricityTax": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "savingsShare": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "estimatedConsumption": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "offshoreFee": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "p19Fee": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "exchangeFee": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      },
      "savingToComparisonTariff": {
        "value": 123,
        "unit": {},
        "unitText": "<string>"
      }
    }
  ],
  "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:
ComponentDescription
baseServiceFeemonthly service fee
variableServiceFeeper kWh service fee
baseGridFeemonthly grid fees, defined by the local grid operator (DSO)
variableGridFeeper kWh grid fees, defined by the local grid operator (DSO)
meteringFeemonthly metering cost, defined by the metering operator
expectedEnergyCostthe expected cost per kWh on the EPEX Day-Ahead market, for the next month
exchangeFeeEnergy market fee
guaranteeOfOriginthe cost per kWh for the guarantee of origin for renewable energy
concessionFeeconcession fee (per kWh) as defined by the local municipality
kwkgFeeapplicable fee according to the German Heat-and-power Cogeneration Act (KWKG)
electricityTaxGerman electricity tax
offshoreFeeOffshore fee
p19FeeSpecial 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

OK

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).

​
refUri
string<uri> | null
read-only

Optional reference URI to point to the resulting resource.

​
data
object[]

Returned data instance.

​
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