Developer API

Solar forecasts for your own automations.

The v1 API is intentionally small: one authenticated forecast endpoint, the same validated forecast engine as the website, and conservative rate limits.

New to the API? Read our step-by-step guide to using solar forecasts in automations and dashboards.

Endpoint

POST /api/v1/forecast

curl https://solarforecast.uk/api/v1/forecast \
  -H "Authorization: Bearer sf_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "postcode":"TF3 4XX",
    "arrays":[{"name":"South roof","capacityKw":4,"azimuth":0,"tilt":35}],
    "lossPct":18,
    "inverterLimitKw":3.68
  }'

API keys belong in the Authorization header, never a URL. The endpoint does not enable cross-origin browser access by default. Identical requests share the forecast cache with the website.

Limits and security

5/minper API key120/dayper API key16 KiBmaximum request6 arraysper forecast5active keys per account240/dayper account

Keys are generated from cryptographic random bytes and only a SHA-256 hash is stored. The plaintext key is shown once. Each key can be independently revoked.

Get an API key

Sign in or create an account, then return here to create a key.