Returns the public logged-out electricity comparison for a German postal code and a yearly consumption in kWh. Each tariff carries the provider, logo, tariff name, shown monthly price and its basis, the later monthly price, the working and base price, the bonus, green and dynamic flags, the minimum term, the price guarantee, rating, score and badges. Annual and first year costs are derived without bonuses so tariffs stay comparable. Send green_only or exclude_dynamic to filter rows, sortField and sortOrder to sort, and limit to cap the list. Prices are numbers in EUR; ids and links pass through unchanged. total counts tariffs after filters and before limit; returned is the number in this answer. Price sorting uses the shown monthly price.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
3 required parameters needed before sending a request.
5 optional filters available.
integer
Required
1 for electricity, 2 for gas.
1
string
Required
Five digit German postal code.
10178
integer
Required
Yearly consumption in kWh, 100 to 100000. 3500 for electricity and 20000 for gas are typical.
3500
string
Optional
price or popularity. Defaults to price.
example
string
Optional
asc or desc. Defaults to asc.
example
boolean
Optional
Set true to keep only tariffs flagged as green.
true
boolean
Optional
Set true to drop dynamic tariffs.
true
integer
Optional
Maximum number of tariffs, 1 to 25. All tariffs are returned by default.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
city
meta
total
product
success
summary
tariffs
currency
+7 more
Common tariffs fields
green
score
badges
rating
{
"city": "Berlin",
"meta": {
"duration_ms": 1200,
"upstream_calls": 2
},
"total": 199,
"product": "electricity",
"success": true,
"summary": "199 Tarife ab 95,39 \u20ac pro Monat",
"tariffs": [
{
"green": true,
"score": 8.1,
"badges": [
"Sofortbonus: 366 \u20ac"
],
"rating": 4.6,
"tariff": "Example Strom L",
"dynamic": false,
"min_term": "18 Monate",
"position": 1,
"provider": "Example Provider",
"bonus_eur": 366,
"later_from": "ab 13. Monat",
"shown_basis": "\u00d8 pro Monat",
"rating_count": 3329,
"provider_logo": "https://cdn.example.de/logo/provider.png",
"annual_cost_eur": 1510.9,
"price_guarantee": "12 Monate",
"renewable_share": "100 % erneuerbar",
"later_monthly_eur": 125.89,
"shown_monthly_eur": 95.39,
"first_year_cost_eur": 1144.9,
"base_price_eur_month": 10.35,
"working_price_ct_kwh": 39.62
}
],
"currency": "EUR",
"returned": 1,
"zip_code": "10178",
"product_id": 1,
"results_url": "https://energie.check24.de/ergebnis/strom/?calculationParameterId=c20647a6fce65abaaa0238ae17ba9de1&pid=24",
"calculation_id": "c20647a6fce65abaaa0238ae17ba9de1",
"consumption_kwh": 3500,
"local_default_tariff": {
"tariff": "Grundversorgung",
"logo_url": "https://cdn.example.de/logo/local.png",
"provider": "Example Local Provider",
"monthly_eur": 132.5
}
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
Returned when a required parameter is missing, a postal code is unknown or a value is out of range. No credits are charged.
Not Found
Returned when Check24 does not know the requested comparison. No credits are charged.
Unexpected Response
Returned when Check24 answers with a page this API cannot read. Failed requests are not charged.
Service Unavailable
Returned when Check24 could not be read. Failed requests are not charged. Try again.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.