# tounify — Full Product Reference

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

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 (e.g. `/v2/`)
- **Example request:** `curl -H "Authorization: Bearer YOUR_KEY" https://api.tounify.io/v2/DE/consumption/tariffs`
- **Path structure:** `/{version}/{country_code}/{tariff_direction}/tariffs`
- **Tariff directions:** `consumption`, `feedin`, `grid`

## Tariff Types

### Static Tariffs
Standardized energy pricing models with fixed or scheduled rates.
- 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 electricity prices.
- 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 pricing models decoded and normalized from supplier rules or regulatory formulas.
- Programmatic replication of formula-based tariffs
- Regulatory authority pricing schemes (e.g. regulated tariff frameworks)
- Fully decoded into machine-readable JSON

## Country Coverage

18+ European countries with active tariff data. Coverage expands regularly.

**Active markets:** Austria (AT), Belgium (BE), Bulgaria (BG), Croatia (HR), Cyprus (CY), Czechia (CZ), Denmark (DK), Estonia (EE), Finland (FI), France (FR), Germany (DE), Greece (GR), Hungary (HU), Ireland (IE), Italy (IT), Latvia (LV), Lithuania (LT), Luxembourg (LU), Malta (MT), Monaco (MC), Netherlands (NL), Norway (NO), Poland (PL), Portugal (PT), Romania (RO), Slovakia (SK), Slovenia (SI), Spain (ES), Sweden (SE), Switzerland (CH)

**Coming soon / partial:** Albania (AL), Andorra (AD), Belarus (BY), Bosnia and Herzegovina (BA), Iceland (IS), Kosovo (XK), Liechtenstein (LI), Moldova (MD), Montenegro (ME), North Macedonia (MK), San Marino (SM), Serbia (RS), Turkey (TR), Ukraine (UA), United Kingdom (GB), Vatican City (VA)

Population covered by active markets: 300M+ inhabitants.

## 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. **AI Invoice Scanner** — Crowdsourced data pipeline: the free AI tool for consumers extracts tariff data from uploaded electricity bills, feeding hyper-local pricing details back into the B2B database.
7. **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 test token is available with no credit card required — contact `connect@tounify.io` with subject "Test Token Request".

## Integration Flow

1. **Connect** — Receive API token, integrate REST API. Full documentation available at `https://api.tounify.io`.
2. **Select** — Filter by country code, tariff direction, and tariff type. Receive thousands of 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 tounify?**
tounify is a unified REST API providing developers with direct access to comprehensive European electricity and grid tariffs. Instead of scraping dozens of provider websites or interpreting complex regulatory documents, developers get clean, standardized JSON data for static, dynamic, and synthetic pricing models.

**Does the API provide EPEX Spot / day-ahead prices?**
Yes. tounify delivers exchange-linked dynamic tariffs including day-ahead electricity prices based on EPEX Spot and Nord Pool markets — the exact data required for smart EV charging and HEMS systems.

**How often is data updated?**
Dynamic tariffs are synced daily. Static and synthetic tariffs are continuously monitored by automated crawlers, ensuring up-to-date, verified data.

**Do I need a credit card for testing?**
No. A free test token is available on request, without a credit card.

## 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)
- [Contact / API Access](mailto:connect@tounify.io)
- [Concise summary](https://tounify.io/llms.txt)