Skip to main content
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

Use coordinates for faster and more accurate responses, instead of addresses.

Country Code (Required)

The country code is the primary market identifier and is required for all requests, unless using location_id.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 Mapbox or 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 our geocoder service
  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..

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": 0.9
      }
    }
  }
  // Other response data...
}
  • input_address: The address you provided (if applicable)
  • coordinates: The exact coordinates used to determine pricing
  • confidence: Geocoding confidence score (0-1, with 1 being highest)

​
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.

​
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.