This quickstart guide will help you start using the Prezio API to access electricity pricing data across European markets.

​
Authentication

Prezio uses key-based authentication for all API requests:
1

Get Your API Key

Obtain an API key by:
2

Use the Key in Requests

Include your API key in the Authorization header with every API request:
Authorization: Token YOUR_API_KEY
Keep your API key secure. Don’t expose it in client-side code or public repositories.

​
API Workflow

Starting point: Before making API calls, you need a specific location (address or coordinates) for the end-user’s price you’re looking for. By providing a precise location, the API will be able to return the correct prices applicable to that specific area.
The diagram below shows the typical workflow for retrieving electricity pricing data with the Prezio API:

​
API Request Flow

Follow this step-by-step process to retrieve accurate pricing data:
1

Find Applicable Organizations

First, determine which organizations (grid operators, retailers, authorities) serve your location:
curl -X GET "https://sandbox.prezio.eu/api/organizations/?country=DK&address=Rådhuspladsen 1, Copenhagen" \
  -H "Authorization: Token YOUR_API_KEY"
This returns organizations applicable to the address, including their IDs which you’ll need for the next step.
Select the organization IDs you’re interested in (e.g., a specific retailer and the local grid operator).
2

Get Applicable Tariffs

Next, retrieve the applicable tariffs for each selected organization:
curl -X GET "https://sandbox.prezio.eu/api/tariffs/?country=DK&address=Rådhuspladsen 1, Copenhagen&organization_id=org_70" \
  -H "Authorization: Token YOUR_API_KEY"
Select the tariff IDs that match your criteria (e.g., residential customer type, consumption range).
3

Get Current Prices or Calculate Costs

Finally, use the selected tariff IDs to either get current prices or calculate costs:
curl -X GET "https://sandbox.prezio.eu/api/live/?country=DK&tariff_id=tar_456&tariff_id=tar_789&address=Rådhuspladsen 1, Copenhagen" \
  -H "Authorization: Token YOUR_API_KEY"
This returns current electricity prices for all components of the selected tariffs.

​
Understanding Responses

API responses are in JSON format. Here’s a simplified example of a response from the /live/ endpoint: 
{
  "context": {
    "currency": "DKK",
    "unit": "per_kwh",
    "location": {
      "coordinates": {
        "latitude": 55.6761,
        "longitude": 12.5683
      }
    }
  },
  "results": [
    {
      "interval_start": "2023-10-15T14:00:00Z",
      "elements": [
        {
          "id": "com_123",
          "price": "0.521000"
        },
        {
          "id": "com_456",
          "price": "1.045000"
        }
      ],
      "interval_price": "1.566000"
    }
  ]
}

​
API Environments

Use the same API key for both environments, but call different base URLs:

Sandbox

URL: https://sandbox.prezio.eu/api/Access: Open to all registered users
Purpose: Development and testing with limited data coverageData availability →

Production

URL: https://api.prezio.eu/api/Access: Requires contract (contact support)
Purpose: Production applications with complete data coverage
Production access depends on your contract. Contact support@prezio.eu to enable production access.

​
Beta Features

Beta Endpoints Available: Some API endpoints are currently in beta. These features are subject to changes and errors.
For detailed information about beta endpoints, see the API Reference, and don’t hesitate to contact us.

​
Next Steps

API Reference

Browse all available endpoints and parameters

Location Guide

Learn how to specify locations correctly

Tariffs Guide

Understand tariff structures and components
Having questions? Contact our support team.