Day Ahead Working Price - RABOT Partner API

GET

partner

customers

{customerNumber}

contracts

{contractNumber}

dayaheadworkingprice

Get 15-minute day-ahead working prices for a contract within a given time range

curl --request GET \
  --url https://api.rabot-charge.de/partner/v1/customers/{customerNumber}/contracts/{contractNumber}/dayaheadworkingprice \
  --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": {
    "contractNumber": "<string>",
    "customerNumber": "<string>",
    "dataAvailableAt": "2023-11-07T05:31:56Z",
    "priceData": [
      {
        "timestamp": "2023-11-07T05:31:56Z",
        "workingPrice": {
          "total": 123,
          "vat": 123
        },
        "components": {
          "energyPrice": {
            "total": 123,
            "spotPrice": 123
          },
          "procurementCosts": {
            "total": 123,
            "exchangeFee": 123,
            "greenCertificatesSurcharge": 123,
            "riskPremium": 123
          },
          "gridFees": {
            "total": 123,
            "variableGridFee": 123
          },
          "leviesAndTaxes": {
            "total": 123,
            "offshoreFee": 123,
            "p19Fee": 123,
            "powerHeatCouplingFee": 123,
            "powerIndividualConcessionFee": 123,
            "shutdownFee": 123,
            "electricityTax": 123
          }
        },
        "interval": "<string>"
      }
    ],
    "tariffType": "<string>",
    "currency": "<string>",
    "unit": "<string>"
  }
}

Returns contract-specific working price data based on day-ahead market prices (EPEX spot auction, DE area), combined with procurement costs, grid fees, and levies for the 15-minute intervals within the requested date range. All timestamps are in Europe/Berlin time zone. Prices are returned as ct/kWh, inclusive of VAT. The working price reflects the same pricing logic used by RABOT’s own optimisation systems and is intended for asset steering and consumption optimisation. It is not equivalent to the billed settlement price. Day-ahead prices are determined daily for the following day and are available via the API after 16:00. The endpoint returns data across a rolling three-day window spanning yesterday (Day X-1), today (Day X), and tomorrow (Day X+1). Use the from and to request parameters to define the date range. Both parameters are required and use an exclusive upper bound — to retrieve data for a single day, set to to the following date (e.g. from=2026-03-30&to=2026-03-31).

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

Query Parameters

from

string<date>

Start of the time range (inclusive)

string<date>

End of the time range (exclusive)

Response

200 - application/json

API response DTO with data.

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 | null

Returned data instance.

Hide child attributes

data.contractNumber

string

required

The contract number.

data.customerNumber

string

required

The customer number.

data.dataAvailableAt

string<date-time>

required

When the DA prices became available (4pm the day before the delivery date, CET).

data.priceData

object[]

required

List of 15-minute day-ahead working price entries.

Hide child attributes

data.priceData.timestamp

string<date-time>

required

UTC timestamp of the 15-minute interval start.

data.priceData.workingPrice

object

required

Total working price and VAT for the interval.

Hide child attributes

data.priceData.workingPrice.total

number<double>

required

Total working price including VAT (ct/kWh).

data.priceData.workingPrice.vat

number<double> | null

required

VAT amount (ct/kWh).

data.priceData.components

object

required

Breakdown of the working price into individual cost components.

Hide child attributes

data.priceData.components.energyPrice

object

required

Energy price component, including spot price.

Hide child attributes

data.priceData.components.energyPrice.total

number<double> | null

Total energy price (ct/kWh). Null when spot price is unavailable.

data.priceData.components.energyPrice.spotPrice

number<double> | null

EPEX day-ahead spot price (ct/kWh). Null when unavailable.

data.priceData.components.procurementCosts

object

required

Procurement cost component.

Hide child attributes

data.priceData.components.procurementCosts.total

number<double>

required

Total procurement costs (ct/kWh).

data.priceData.components.procurementCosts.exchangeFee

number<double>

required

Exchange fee (ct/kWh).

data.priceData.components.procurementCosts.greenCertificatesSurcharge

number<double>

required

Green certificates surcharge (ct/kWh).

data.priceData.components.procurementCosts.riskPremium

number<double>

required

Risk premium (ct/kWh).

data.priceData.components.gridFees

object

required

Grid fee component.

Hide child attributes

data.priceData.components.gridFees.total

number<double>

required

Total grid fees (ct/kWh).

data.priceData.components.gridFees.variableGridFee

number<double>

required

Variable grid fee (ct/kWh). Dynamic when §14a module is registered.

data.priceData.components.leviesAndTaxes

object

required

Levies and taxes component.

Hide child attributes

data.priceData.components.leviesAndTaxes.total

number<double>

required

Total levies and taxes (ct/kWh).

data.priceData.components.leviesAndTaxes.offshoreFee

number<double>

required

Offshore surcharge — Offshore-Netzumlage (ct/kWh).

data.priceData.components.leviesAndTaxes.p19Fee

number<double>

required

§19 StromNEV surcharge (ct/kWh).

data.priceData.components.leviesAndTaxes.powerHeatCouplingFee

number<double>

required

Combined heat and power surcharge — KWKG-Umlage (ct/kWh).

data.priceData.components.leviesAndTaxes.powerIndividualConcessionFee

number<double>

required

Individual concession fee — individuelle Konzessionsabgabe (ct/kWh).

data.priceData.components.leviesAndTaxes.shutdownFee

number<double>

required

Shutdown surcharge — Stilllegungsumlage (ct/kWh).

data.priceData.components.leviesAndTaxes.electricityTax

number<double>

required

Electricity tax — Stromsteuer (ct/kWh).

data.priceData.interval

string

read-only

Duration of the interval. Always 15min.

data.tariffType

string

read-only

Tariff type. Always dynamic.

data.currency

string

read-only

Currency of all price values. Always EUR.

data.unit

string

read-only

Unit of all price values. Always cent/kWh.

Day-Ahead market pricesGet energy prices based on day-ahead market

⌘I

Get 15-minute day-ahead working prices for a contract within a given time range

curl --request GET \
  --url https://api.rabot-charge.de/partner/v1/customers/{customerNumber}/contracts/{contractNumber}/dayaheadworkingprice \
  --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": {
    "contractNumber": "<string>",
    "customerNumber": "<string>",
    "dataAvailableAt": "2023-11-07T05:31:56Z",
    "priceData": [
      {
        "timestamp": "2023-11-07T05:31:56Z",
        "workingPrice": {
          "total": 123,
          "vat": 123
        },
        "components": {
          "energyPrice": {
            "total": 123,
            "spotPrice": 123
          },
          "procurementCosts": {
            "total": 123,
            "exchangeFee": 123,
            "greenCertificatesSurcharge": 123,
            "riskPremium": 123
          },
          "gridFees": {
            "total": 123,
            "variableGridFee": 123
          },
          "leviesAndTaxes": {
            "total": 123,
            "offshoreFee": 123,
            "p19Fee": 123,
            "powerHeatCouplingFee": 123,
            "powerIndividualConcessionFee": 123,
            "shutdownFee": 123,
            "electricityTax": 123
          }
        },
        "interval": "<string>"
      }
    ],
    "tariffType": "<string>",
    "currency": "<string>",
    "unit": "<string>"
  }
}