Pages

Get a list of organisations

Returns organisations and their roles within the renewable energy industry.

GET https://api.renewmap.com.au/api/v1/organisations
Requires API key in Authorization header. See Getting started for authentication details.

Query parameters

Name Type Default Description
limit integer 100 Limit the number of results returned (maximum 10000)
offset integer 0 Offset from the first record returned (for pagination)

Example request

curl --request GET \
  --url 'https://api.renewmap.com.au/api/v1/organisations' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'accept: application/json'

Example response

{
  "organisations": [
    {
      "id": "c3f1a2b4-5d6e-7f8a-9b0c-d1e2f3a4b5c6",
      "organisation_name": "Acme Energy",
      "url": "https://www.acmeenergy.com.au",
      "roles": ["Developer", "Owner"]
    }
  ]
}

The roles array contains the distinct set of roles the organisation holds across all linked projects and infrastructure, sorted alphabetically. Roles include values such as “Developer”, “Owner”, “Battery OEM”, “Turbine OEM”, “Contractor”, and others.

An organisation with no entity links will have an empty roles array.