<!-- GENERATED by scripts/sync-public-corpus.mjs — do not edit. Edit packages/public-corpus/llms-copy.ts. -->
# tounify — Full Product Reference

> Europe's unified energy tariff data API — one REST API for static, dynamic, and synthetic electricity pricing across European markets.

tounify is a B2B REST API that provides developers and energy-tech companies with normalized, verified European electricity tariff data. The platform eliminates the need to scrape hundreds of energy supplier websites or parse complex regulatory documents — all tariff types are unified into a single, consistent JSON schema.

## Product Summary

**What it is:** A unified REST API for European electricity tariff data.
**Who it is for:** Developers and B2B companies building energy management apps, smart charging solutions, HEMS, and analytics platforms.
**Core value:** One API, all tariff types, all covered European countries — no scraping, no data wrangling.

## API Technical Details

- **Base URL:** `https://api.tounify.io`
- **Authentication:** Bearer token via `Authorization` header
- **Response format:** JSON
- **Versioning:** URL-based (`/v2/` is current; `/v1/` is deprecated)
- **Getting a token:** register at https://cockpit.tounify.io/register — a testing token is issued
  immediately, no credit card and no sales call.
- **Endpoint reference for agents:** https://api.tounify.io/llms.txt
- **Machine-readable spec:** https://api.tounify.io/openapi/v2.json — OpenAPI 3, generated from the
  live controllers, so it cannot drift from the API
- **Tariff directions (`{sector}`):** `consumption`, `feedin`, `grid`
- **Country codes:** ISO 3166-1 alpha-2 — `DE` not `GER`, `GB` not `UK`.

Reaching a price takes three calls. A tariff belongs to a company, so the company id is a required
path segment when listing tariffs:

```bash
curl -H "Authorization: Bearer $TOKEN" \
  https://api.tounify.io/v2/DE/consumption/companies              # -> company ids

curl -H "Authorization: Bearer $TOKEN" \
  https://api.tounify.io/v2/DE/consumption/{company}/tariffs      # -> tariff ids

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.tounify.io/v2/DE/dayahead?consumption_tariff={tariff}&include=fees,vat"
```

In an unbundled market the consumption tariff is the bare energy price. Pass `grid_tariff` as well,
and `include=fees,vat`, to get what a customer actually pays — the response carries a `warnings`
array naming anything that was omitted.

## Tariff Types

### Static Tariffs
Standardized energy pricing models, including time-of-use (TOU) rates like day/night or peak/off-peak variations.
- Standard fixed-price tariffs
- Time-of-use (TOU) rates: day/night, peak/off-peak, multi-period
- Applies to consumption, feed-in, and grid pricing

### Dynamic Tariffs
Real-time, exchange-linked pricing. Access day-ahead electricity prices and EPEX Spot market data streams required for smart charging.
- Day-ahead spot market prices (EPEX Spot)
- Nord Pool market data
- Ideal for smart charging, HEMS, demand-response
- Updated daily as new market prices are published

### Synthetic Tariffs
Complex models calculated based on supplier rules or regulatory authorities - fully decoded and normalized for your API.
- Programmatic replication of formula-based tariffs
- Regulatory authority pricing schemes (e.g. regulated tariff frameworks)
- Fully decoded into machine-readable JSON

## Country Coverage

Coverage changes continuously, so no country list is baked into this file. `GET https://api.tounify.io/public/country-stats` needs no token and returns, per country, the number of companies and tariffs held for each direction, whether statutory fees are loaded, and whether postal-code to network-operator resolution is available. The same figures are rendered live at https://tounify.io/#coverage.

A market being absent from that endpoint means no data is loaded for it yet, not that it is
unsupported in principle.

## Data Sources

tounify aggregates electricity tariff data from multiple verified channels:

1. **Automated Web Crawler** — Purpose-built crawler that monitors energy supplier websites for price changes and tariff updates on a regular schedule.
2. **API Connections** — Direct integration with energy provider APIs and wholesale markets (EPEX Spot, Nord Pool) for real-time data synchronization.
3. **Synthetic Tariff Replication** — Programmatic calculation of formula-based tariffs from published energy pricing rules and supplier specifications.
4. **Regulatory Documents** — Automated extraction from regulatory public documents and official government energy authority publications.
5. **Open Data Integration** — European open data sources used for price verification and additional coverage.
6. **Manual Verification** — Human review for complex or edge-case markets using internal tooling.

## Data Freshness

- **Dynamic tariffs (day-ahead prices):** Updated daily as soon as new spot market prices are published (typically by 13:00 CET for the following day).
- **Static & synthetic tariffs:** Continuously monitored by automated crawlers and AI systems; updated when changes are detected.

## Use Cases

### Smart EV Charging
Feed dynamic day-ahead prices into charging algorithms to schedule sessions during the cheapest hours. Reduce end-user charging costs by 20–40%.

### Home Energy Management Systems (HEMS)
Power HEMS controllers with real-time tariff data to optimize heat pumps, battery storage, and appliance scheduling.

### EV Fleet Cost Reimbursement
Match per-kWh home electricity tariffs to charging sessions for accurate, auditable cost reimbursement for fleet drivers charging at home.

### Energy Management Apps
Provide end users with price transparency — show current and upcoming tariff rates, cost breakdowns, and price forecasts.

### Analytics & Price Forecasting
Use historical and real-time tariff data as input for energy price models, market analysis, and demand-response algorithms.

## Pricing Plans

All plans include full API access and complete European country coverage. Prices exclude VAT. Billing is monthly.

| Plan       | EUR/month | API calls included | Additional calls  | Support level          |
|------------|-----------|--------------------|-------------------|------------------------|
| STARTER    | 89        | 1,000              | EUR 0.10 / call   | Email Assistance       |
| PRO        | 349       | 145,000            | EUR 0.003 / call  | Developer Fast-Track   |
| ENTERPRISE | 990       | 485,000            | EUR 0.002 / call  | Direct Dev-Access      |
| ULTIMATE   | 1,350     | 750,000            | EUR 0.001 / call  | Engineering Partnership |

- **PRO** is the most popular plan for production use.
- **ENTERPRISE** and **ULTIMATE** plans include direct engineering support.
- Custom / volume plans available on request via `connect@tounify.io`.

A free testing token is available with no credit card required and no sales call — register at
https://cockpit.tounify.io/register and it is issued immediately. It is meant for evaluation, so it
is capped on breadth rather than on request count: 20 different companies and 20 different tariffs
over its lifetime, 5 newly explored scopes per day, and 7 days of validity (renewable from the Token
page). Re-asking about something already looked up is free and never counts again.

## Integration Flow

1. **Connect** — Register, copy the token from the Token page, integrate the REST API. Full
   documentation at `https://api.tounify.io`.
2. **Select** — Filter by country code, tariff direction, and tariff type. Receive verified tariffs in a unified JSON schema.
3. **Empower** — Deliver price transparency, power smart charging algorithms, or feed analytics models with high-resolution market data.

## Frequently Asked Questions

**What is the tounify-API?**
tounify is a unified REST API that provides developers with direct access to comprehensive European electricity and grid tariffs. Instead of scraping dozens of provider websites or interpreting complex regulatory documents, you get clean, standardised JSON data for static, dynamic, and synthetic pricing models.

**Does the API provide day-ahead EPEX spot market prices?**
Yes, absolutely. We deliver exchange-linked dynamic tariffs, including day-ahead electricity prices based on the EPEX and North Pool spot markets. This is the exact data required to build intelligent Home Energy Management Systems (HEMS) or smart EV charging algorithms.

**How often is the electricity tariff data updated?**
Dynamic tariffs (like exchange-linked prices) are synced daily as soon as the new spot market prices are published. Static and synthetic tariffs are continuously monitored by our automated crawlers and AI systems, ensuring you always operate on verified, up-to-date data.

**Which European countries are currently supported?**
tounify currently provides verified energy tariff data for {countryCount} European countries, normalising complex local market structures into a single JSON format.

**Can I use this data for smart EV charging and HEMS?**
Yes, that is one of our main use cases. By feeding our high-resolution tariff data into your algorithms, your applications can automatically schedule energy-intensive tasks (like charging an electric vehicle or running heat pumps) during the cheapest hours of the day.

**Do I need a credit card to get a test token?**
No. Creating an account issues a testing token straight away — free of charge, no credit card, and no waiting on a sales reply. Your development team can evaluate the JSON endpoints and start building immediately.

## Links

- [Website](https://tounify.io)
- [API Documentation](https://api.tounify.io)
- [Pricing](https://tounify.io/#pricing)
- [Coverage Map](https://tounify.io/#coverage)
- [Tariff Types](https://tounify.io/#tariff-types)
- [Get API access (self-serve)](https://cockpit.tounify.io/register)
- [Sales / custom plans](mailto:connect@tounify.io)
- [Concise summary](https://tounify.io/llms.txt)