Electricity pricing varies by location due to different grid operators, market regions, and regulatory frameworks. The Prezio API uses precise location data to determine applicable tariffs.

​
Specifying Location

Country code is ALWAYS required for all location-based requests, regardless of whether you use an address or coordinates.

Country Code (Required)

The country code is the primary market identifier and is required for all requests.It corresponds to the country code used in the ISO 3166-1 alpha-2 standard.
# Required parameter for all location-based requests
country=DK
To get the most up-to-date list of supported countries:
GET /countries/
Prezio automatically geocodes addresses to coordinates using OpenStreetMap services.
# Full text address (must be used with country)
country=DK&address=Rådhuspladsen 1, Copenhagen

​
Geocoding Process

  1. The API converts your address to coordinates using OpenStreetMap
  2. Validates that the geocoded location is within the specified country
  3. Uses the resulting coordinates to determine applicable tariffs
  4. Includes a confidence score in the response (higher is better)
Include street number, street name, city, and postal code for best geocoding results.
For address conversion debugging, you can use the OpenStreetMap UI.
For precise location targeting, provide direct geographic coordinates.
# Latitude and longitude values (must be used with country)
country=DK&latitude=55.6761&longitude=12.5683
Both latitude and longitude must be provided together in decimal degrees (WGS84 coordinate system).

Location Data in Responses

API responses include the location data used for the request, allowing you to verify correct interpretation:
{
  "context": {
    "location": {
      "input_address": "Rådhuspladsen 1, Copenhagen",
      "coordinates": {
        "latitude": 55.6761,
        "longitude": 12.5683,
        "confidence": 9
      }
    }
  }
  // Other response data...
}
  • input_address: The address you provided (if applicable)
  • coordinates: The exact coordinates used to determine pricing
  • confidence: Geocoding confidence score (1-10, with 10 being highest)
Never provide both address and coordinates in the same request. Choose one method to specify location.

​
How Location Affects Pricing

Grid Operator

Your location determines which DSO (Distribution System Operator) serves your area, affecting grid costs.

Regional Tariffs

Organizations may have different tariffs for different geographic regions within the same country.

Local Taxes

Some electricity taxes and fees vary by municipality or region.

​
Example Requests

GET /tariffs/?country=DK&address=Rådhuspladsen 1, Copenhagen
Returns tariffs applicable to the specified address in Denmark.

​
Location Best Practices

Use Exact Locations

Provide the exact address where electricity is consumed, not approximate locations, to ensure correct tariff assignment.

Handle Geocoding Errors

Implement error handling for cases where addresses cannot be geocoded or return low confidence scores.

Verify Country Codes

Double-check that you’re using the correct country code for your location to avoid empty results.

Check Data Availability

Not all locations have data in the sandbox environment. Review our data availability guide for testing.
For most reliable results in production applications, we recommend caching the mapping between addresses and DSO service areas after initial lookups.