Skip to main content
GET
/
organizations
/
List Organizations
curl --request GET \
  --url https://sandbox.prezio.eu/api/organizations/ \
  --header 'Authorization: <api-key>'
{
  "count": 12,
  "next": "https://api.prezio.eu/api/organizations/?country=DK&address=Copenhagen&page=2",
  "previous": null,
  "context": {
    "location": {
      "input_address": "Copenhagen",
      "coordinates": {
        "latitude": 55.6867,
        "longitude": 12.5701,
        "confidence": 0.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. Ignored if location_id is provided.

​
consumer_type
enum<string>

Filter by consumer type (RESIDENTIAL or BUSINESS).

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

ISO-3166 alpha-2 country code of the requested location. Used to ensure geographic correctness. Required unless location_id is provided.

Available options:
AT,
DE,
DK,
ES,
FI,
GB,
NO,
RO,
SE
​
latitude
number

Latitude coordinate (must be used together with longitude). Ignored if location_id is provided.

​
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

​
location_id
string

ID of a saved Location object. When provided, takes precedence over country/address/coordinates parameters.

​
longitude
number

Longitude coordinate (must be used together with latitude). Ignored if location_id is provided.

​
page
integer

A page number within the paginated result set.

​
page_size
integer

Number of results to return per page.

​
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

OK

​
count
integer

Total number of items across all pages

Example:

12

​
next
string | null

URL for the next page of results, null if no next page

Example:

"https://api.prezio.com/api/organizations/?page=2"

​
previous
string | null

URL for the previous page of results, null if no previous page

Example:

"https://api.prezio.com/api/organizations/?page=1"

​
context
object
​
results
object[]