GET
/
organizations
/
List Organizations
curl --request GET \
  --url https://sandbox.prezio.eu/api/organizations/ \
  --header 'Authorization: <api-key>'
{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "count": 3,
      "next": "https://api.prezio.eu/api/organizations/?country=DK&latitude=55.6761&longitude=12.5683&page=2",
      "previous": null,
      "context": {
        "location": {
          "input_address": "Copenhagen, Denmark",
          "coordinates": {
            "latitude": 55.6867,
            "longitude": 12.5701,
            "confidence": 9
          }
        }
      },
      "results": [
        {
          "id": "org_123",
          "name": "Radius Elnet",
          "type": "DSO",
          "website_url": "https://radiuselnet.dk",
          "logo": "https://api.prezio.eu/media/logos/radius.png",
          "main_tariffs": [
            {
              "id": "mta_456",
              "name": "C Tariff",
              "description": "Standard residential tariff"
            }
          ],
          "default_main_tariff": "mta_456",
          "consumer_types": [
            "RESIDENTIAL",
            "BUSINESS"
          ]
        },
        {
          "id": "org_124",
          "name": "Andel Energi",
          "type": "RET",
          "website_url": "https://andelenergi.dk",
          "logo": "https://api.prezio.eu/media/logos/andel.png",
          "main_tariffs": [
            {
              "id": "mta_789",
              "name": "Flex Spot",
              "description": "Variable rate electricity plan"
            }
          ],
          "default_main_tariff": "mta_789",
          "consumer_types": [
            "RESIDENTIAL"
          ]
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Query Parameters

​
address
string

Full address to search for applicable organizations. Cannot be used with latitude/longitude.

​
consumer_type
enum<string>

Filter by consumer type (RESIDENTIAL or BUSINESS).

Available options:
BUSINESS,
RESIDENTIAL
​
country
enum<string>
required

Country code of the requested location. Used to ensure geographic correctness.

  • DK: Denmark
  • SE: Sweden
  • NO: Norway
Available options:
DK,
NO,
SE
​
latitude
number

Latitude coordinate (must be used together with longitude). Cannot be used with address.

​
longitude
number

Longitude coordinate (must be used together with latitude). Cannot be used with address.

​
page
integer

A page number within the paginated result set.

​
search
string

A search term.

​
type
enum<string>[]

Filter by organization type. Can be repeated for multiple types (e.g., ?type=DSO&type=RET). Available types:

  • DSO: Distribution/Grid operator
  • TSO: Transmission operator
  • RET: Electricity retailer/supplier
  • AUTH: Authorities
  • TAX: Tax authority
  • OTHER: Other
​
valid_at
string

Filter for organizations valid at the specified datetime (format: YYYY-MM-DD). If omitted, returns organizations valid at the current time.

Response

200
application/json

Success. Returns a paginated list of organizations applicable for the specified location. The response includes organization details like name, type, and available tariffs, along with context information about the location.

The response is of type object.