API Workflow
The diagram below shows the typical workflow for retrieving electricity pricing data with the Prezio API:The
/countries/ endpoint is available to discover supported countries but is not required for most workflows. You can proceed directly with country codes (e.g., “DK”, “SE”, “NO”) if you already know which country you’re working with.- Start with a location - The end-user’s address or coordinates
- Find applicable organizations - Discover which DSOs, retailers, etc. serve that location
- Get relevant tariffs - Retrieve tariffs from the organization you select (repeat for all organizations contributing to the end-user’s total price)
- Get pricing information - Use either the
/live/endpoint for current prices or/calculate/for specific consumption
Key Concepts
Organizations
Entities in the electricity market (DSOs, retailers, authorities) that provide pricing components
Tariffs
Pricing structures that define how electricity usage is billed by different organizations
Tariff Elements
Individual price components that make up the total electricity cost
Location
Geographic information that determines which organizations and tariffs apply
Data Availability
Understanding which regions and data are available in sandbox vs. production
Core API Endpoints
GET /countries/
GET /countries/
Returns available country codes and supported time intervals to use in subsequent requestsResponse includes:Essential first step to determine which markets and time intervals you can access
- Country codes and names
available_interval_minutes: Supported time resolutions (15, 30, 60 minutes) for each country
GET /organizations/
GET /organizations/
Finds organizations serving a specific locationReturns DSOs, retailers, and other organizations relevant to the location
GET /tariffs/
GET /tariffs/
Retrieves tariffs from specified organizationsReturns available pricing structures that can be used for calculations
GET /live/
GET /live/
Gets current electricity prices for specified tariffsReturns pricing information for the current time period
POST /calculate/
POST /calculate/
Calculates costs based on consumption dataReturns calculated costs for specific consumption amounts
Beta Features
Beta Endpoints Available: Some API endpoints are currently in beta and subject to changes and errors.
API Value
The Prezio API solves critical challenges in the energy industry by providing:Single Integration
Access comprehensive pricing data through one API instead of connecting to dozens of providers, significantly reducing development time.
Standardized Format
Consistent data structure across all markets and providers, making it easy to expand to new regions.
Location Intelligence
Automatically determine applicable tariffs based on geographic location without needing to understand complex market structures.
Complete Price Picture
All price components in one place - grid costs, energy costs, taxes, and fees - giving you the full electricity cost.
New to the Prezio API? Head to our Quickstart Guide to make your first API call, or try out Environment Setup to understand sandbox testing.