Skip to main content
Let’s dive in!
1

Request your API Credentials

Contact your Account Manager at RABOT or our Integration Management Team to get your API client details.
Make sure to always keep your client credentials safe. Do not include client credentials in client side code (smartphone app, web application), as they could easily be extracted and misused. If you think your credentials have been compromised, contact RABOT to invalidate the credentials and get a new secret.
2

Authenticate using the OAuth 2.0 flow

See our guide for reference. Ensure you have the correct scopes!

Authentication

API authentication & Scopes
3

Set up the User Auth Flow to connect their RABOT Tariff

As a HEMS partner using our API, your users will need to authorize your client’s access to their data, please see our guide below for more information

3rd Party Authorization

Generate an authorization link and connect your customer’s RABOT tariff
Store the customerNumber for usage in further API calls, it is a key parameter for generating accessing user data once the accounts are linked
4

Access User Data

With the customerNumber returned in the redirect to successUrl above, you can then query customer and contract information, e.g. by calling the list contracts endpoint:
curl -L 'https://api.rabot-charge.de/partner/v1/customers/:customerNumber/contracts' \
-H 'Authorization: ••••••'
5

Access Pricing Data

Depending on your optimization logic, you can retrieve EPEX day-ahead spot prices and/or the effective WorkingPrice for a specific customer contract.EPEX Day Ahead Spot Price
Request
curl --request GET \
  --url https://api.rabot-charge.de/partner/v1/day-ahead-prices/limited \
  --header 'Authorization: Bearer <token>'
Day Ahead Working Price
Request
curl -L "https://api.rabot-charge.de/partner/v1/customers/:customerNumber/contracts/:contractNumber/metrics?period.from=2025-05-05&period.to=2025-05-06&interval=Hourly&metricType=WorkingPrice&valueType=Combined" \
-H "Authorization: Bearer <token>"
6

Handle the Response

Parse the response by deserializing the returned time-series data and transforming it into a normalized format suitable for chart rendering and optimization logic inputs.

Price Charts

Instantly add frills to your UI and participate in the smartification journey!

​
Next Steps

Hooray! You’ve just authenticated the first user account connection and queried the price data to digest and process as desired. Browse our API endpoints Check out our comprehensive guides for Sales Affilliate partners to ensure a swift and effortless onboarding experience

​
Questions or Concerns?

Feel free to speak with our Integration Management Team or alternatively, ask our built-in AI assistant, Rabotini 🤖 (several languages supported).