Getting started

Find the API specifications for endpoints accessing project, network and turbine data.

Contact us at [email protected] to enable API access

API reference

Introduction

The RenewMap API allows you to fetch up-to-date project data via http. API access is not enabled for RenewMap users by default, and must be purchased separately.

Using the RenewMap API, you can access near real-time data on renewable energy projects, network infrastructure, and wind turbine locations across Australia. This allows for seamless integration with GIS tools, Customer Relationship Management (CRM) systems, data analysis platforms and other custom applications.

Security

It is your responsibility to ensure generated API keys are stored securely and are not used in breach of RenewMap terms of use.

  • API keys may be revoked if anomalous activity is detected
  • API keys have a maximum lifetime of 6 months, after which they will expire

Generating an API key:

  1. Open RenewMap and click the top right settings menu
  2. Select “Access keys”
  3. Click “Generate”
  4. Click the key to copy it to your clipboard

Authentication

Use your generated API key to access RenewMap API endpoints via an Authorization header:

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

Limits

The number of API requests per client is limited to:

  • 5 requests per 10 seconds
  • 100 requests per month

If either of these limits are breached you will receive a 429 response status code calling the RenewMap API until the next time window. RenewMap API uses a fixed time window for rate limiting.