Hobbyist users

Account limits

Configure sites in the toolkit

Create and manage home PV systems at toolkit.solcast.com.au. After adding a system, open View site detail to find your assigned rooftop_resource_id in the site summary. Your API key is also available from the account menu in the toolkit.

• Register and manage home PV systems in the Solcast Toolkit — not via the commercial PV power site API.
• Each site needs capacity (AC/DC), azimuth, tilt, installation date, and efficiency factor configured in the toolkit.
• A second site must use the same latitude and longitude as your first site when both arrays are at the same address.
• Find your rooftop resource ID on the site detail page in the toolkit after saving a home PV system.

Register your first array

1. Add a home PV system. From the dashboard, click Add your first Home PV system to get started, or Add another Home PV system once your first array is registered.
2. Enter array details. Provide capacity (AC/DC), azimuth, tilt, installation date, and efficiency factor, then save the site.
3. Copy your resource ID. Open View site detail. The site summary on the right shows the rooftop_resource_id to use in API requests below.

Toolkit tips

• Open the account username menu to copy your API key or change your password.
• On each site detail page you can preview live and forecast charts, download JSON or CSV, or copy ready-made API URLs.

For API authentication details, see Authentication.

Adding a second array

1. Log in at toolkit.solcast.com.au and open your dashboard.
2. Click Add another Home PV system after your first array is saved.
3. Enter the second array’s capacity, azimuth, tilt, and other details. Use the same latitude and longitude as your first site when both arrays are at the same property.
4. Save the form. Each array appears on the dashboard with its own rooftop_resource_id.

If registration fails, you may see an error like:

([latitude value], [longitude value]) is not within a close proximity to your existing rooftop site

• Hobbyist accounts can register up to two rooftop arrays, but both must be within 1 km of each other.
• If you see the proximity error above, you are adding the second site too far from the first. Check the coordinates on your existing site and enter the same latitude and longitude for the second array.
• If the error persists, delete the original site and re-add it using the same latitude and longitude (or address), then add the second site again.
• For multiple arrays on one roof, model each array as a separate site with its own azimuth and tilt. If estimated actuals look off, adjust capacity or efficiency factor on the site that best matches the array you are comparing against.

Hobbyist API endpoints

Once a rooftop site is registered, use its resource ID in the path below. Authenticate with a Bearer token in the Authorization header, or append api_key= to the query string. JSON and CSV are supported via the format parameter — see Response formats.