# Check24 Electricity Tariffs API Documentation

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.

- **Documentation:** [https://scrappa.co/docs/check24-api/check24_energy_strom](https://scrappa.co/docs/check24-api/check24_energy_strom)
- **API group:** Check24 API
- **Endpoint:** `GET https://scrappa.co/api/check24/energy`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `productId` | integer | Yes | 1 for electricity, 2 for gas. |
| `zipCode` | string | Yes | Five digit German postal code. |
| `totalConsumption` | integer | Yes | Yearly consumption in kWh, 100 to 100000. 3500 for electricity and 20000 for gas are typical. |
| `sortField` | string | No | price or popularity. Defaults to price. |
| `sortOrder` | string | No | asc or desc. Defaults to asc. |
| `green_only` | boolean | No | Set true to keep only tariffs flagged as green. |
| `exclude_dynamic` | boolean | No | Set true to drop dynamic tariffs. |
| `limit` | integer | No | Maximum number of tariffs, 1 to 25. All tariffs are returned by default. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | 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. |
| 404 | Not Found | Returned when Check24 does not know the requested comparison. No credits are charged. |
| 502 | Unexpected Response | Returned when Check24 answers with a page this API cannot read. Failed requests are not charged. |
| 503 | Service Unavailable | Returned when Check24 could not be read. Failed requests are not charged. Try again. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
