Energy Projects AU Solar Assessments API

The Solar Assessments API from Energy Projects AU — 1 operation(s) for solar assessments.

GitHub OpenAPI

Operations 1

POST /api/v1/solar-assessments Assess commercial solar potential at Australian coordinates #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/energy-projects-com-au:energy-projects-com-au-solar-assessments-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

energy-projects-com-au-solar-assessments-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Energy Projects AU Commercial Solar Assessment Solar…
  version: 1.0.0
  description: A read-only screening API for indicative Australian commercial rooftop solar assessments.
  contact:
    name: Energy Projects AU
    email: mike@energy-projects.com.au
    url: https://energy-projects.com.au
servers:
- url: https://energy-projects.com.au
tags:
- name: Solar Assessments
paths:
  /api/v1/solar-assessments:
    post:
      operationId: assessCommercialSolarSite
      summary: Assess commercial solar potential at Australian coordinates
      description: Maps an open building footprint, estimates system capacity and annual generation, then returns indicative gross energy value and incentives. No Google imagery or Places content is returned.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SolarAssessmentInput'
      responses:
        '200':
          description: Assessment completed, including a no-building-match outcome.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SolarAssessment'
        '400':
          description: Invalid request.
        '429':
          description: Rate limit exceeded.
        '502':
          description: Upstream assessment provider failed.
      tags:
      - Solar Assessments
components:
  schemas:
    SolarAssessmentInput:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: object
      additionalProperties: false
      properties:
        latitude:
          type: number
          minimum: -55
          maximum: -9
          description: Latitude of an Australian commercial building.
        longitude:
          type: number
          minimum: 96
          maximum: 168
          description: Longitude of an Australian commercial building.
        state:
          type: string
          enum:
          - ACT
          - NSW
          - NT
          - QLD
          - SA
          - TAS
          - VIC
          - WA
          description: Australian state or territory. Required only to consider state-specific incentives.
        usableRoofCoverage:
          type: number
          minimum: 0.4
          maximum: 0.8
          default: 0.65
          description: Share of the mapped roof assumed usable for panels.
        electricityRateAudPerKwh:
          type: number
          minimum: 0
          maximum: 2
          default: 0.3
          description: Electricity value used for the gross annual energy-value estimate.
      required:
      - latitude
      - longitude
    SolarAssessment:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: object
      additionalProperties: false
      properties:
        assessmentId:
          type: string
          format: uuid
        generatedAt:
          type: string
          format: date-time
        status:
          type: string
          enum:
          - assessed
          - no_building_match
        confidence:
          type: string
          enum:
          - screening_only
        roof:
          anyOf:
          - type: 'null'
          - type: object
            additionalProperties: false
            properties:
              areaM2:
                type: number
              source:
                type: string
                const: Overture Maps
              sourceRelease:
                type: string
            required:
            - areaM2
            - source
            - sourceRelease
        solar:
          anyOf:
          - type: 'null'
          - type: object
            additionalProperties: false
            properties:
              usableRoofCoverage:
                type: number
              potentialSystemKw:
                type: number
              annualGenerationKwh:
                type: number
              annualGenerationSource:
                type: string
                enum:
                - PVGIS
                - generic_fallback
            required:
            - usableRoofCoverage
            - potentialSystemKw
            - annualGenerationKwh
            - annualGenerationSource
        value:
          anyOf:
          - type: 'null'
          - type: object
            additionalProperties: false
            properties:
              electricityRateAudPerKwh:
                type: number
              grossEnergyValueAudPerYear:
                type: number
            required:
            - electricityRateAudPerKwh
            - grossEnergyValueAudPerYear
        incentives:
          type: object
        assumptions:
          type: array
          items:
            type: string
        caveats:
          type: array
          items:
            type: string
        links:
          type: object
          additionalProperties: false
          properties:
            interactiveCalculator:
              type: string
              format: uri
            humanReview:
              type: string
              format: uri
            methodology:
              type: string
              format: uri
          required:
          - interactiveCalculator
          - humanReview
          - methodology
      required:
      - assessmentId
      - generatedAt
      - status
      - confidence
      - roof
      - solar
      - value
      - incentives
      - assumptions
      - caveats
      - links