Skip to main content
GET
/
organizations
/
List Organizations
curl --request GET \
  --url https://sandbox.prezio.eu/api/organizations/ \
  --header 'Authorization: <api-key>'
[
  {
    "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",
        "logo": "https://api.prezio.eu/media/logos/radius.png",
        "local_consumer_types": [
          {
            "id": "lct_42",
            "key": "privatkunder",
            "name": "Privatkunder",
            "consumer_type": "RESIDENTIAL"
          }
        ]
      },
      {
        "id": "org_124",
        "name": "Andel Energi",
        "type": "RET",
        "logo": "https://api.prezio.eu/media/logos/andel.png",
        "local_consumer_types": [
          {
            "id": "lct_43",
            "key": "erhverv",
            "name": "Erhverv",
            "consumer_type": "BUSINESS"
          }
        ]
      }
    ]
  }
]

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

ISO-3166 alpha-2 country code of the requested location. Used to ensure geographic correctness.

Available options:
AT,
DK,
FR,
NO,
SE
​
latitude
number

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

​
local_consumer_type
string[]

Repeatable. Filter by local consumer type using key or lct_ ID. Example: ?local_consumer_type=privatkunder&local_consumer_type=lct_42

​
longitude
number

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

​
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 (ISO 8601 UTC-only format. Accepts dates YYYY-MM-DD). If omitted, returns organizations valid at the current time.

Response

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.

​
count
integer
required
​
next
string<uri> | null
required
​
previous
string<uri> | null
required
​
context
object
required
​
results
object[]
required