Developer Documentation How-Tos and Java Library


| Reading time 1 minute

Over the last few weeks we’ve been making a lot of updates to our developer site. We’ve touched every page of the documentation, added new sections and updated some code. Read on to find out more.


One of the biggest updates to the documentation is the creation of the “How-Tos” section. Whether you just want to add a utility logo to your application or you need to do an entire customer savings analysis, the How-To section is the best place to start.

If you’re just getting familiar with the API, you’ll probably want to start with the Calculate Potential Solar Savings How-To. It outlines the entire process of doing a savings analysis with the Genability API. If you’ve got a nagging question that you can’t answer, the page of common scenarios might come in handy.

Java Client Library

We’ve also made two major updates to the Java client library. The first update is that we’ve brought the library up-to-date with the most recent changes to the API. This includes things like uploading a profile with baseline data instead of reading data or using the populateCosts parameter of the savings analysis endpoint. Every object, endpoint, and parameter in the API is now available through the client library.

The second major update is that we’ve made the Java client library available on the Maven central repo. Now, instead of having to download, import, and compile the library manually, you can just add the following snippet to your pom.xml:


You can see more about the client library on its dedicated GitHub page. Make sure to read the tutorial to see how to get started.

Updated Documentation

Finally, we’ve made a lot of updates – some major, some minor – to almost every page in the GDN. Some of the highlights include:

  • We’ve added a section on the Usage Profile page that describes how to upload solar production data as a modeled baseline rather than as meter reading data. This is now the preferred way to upload any solar production estimates that you’ve created.

  • On the Savings Analysis page, we’ve added a list of inputs that are available to you when using the calculator. Now you’ll know how to set the annual degradation rate for your solar system.

  • The Security page now includes examples of how to authenticate to the API in a number of common languages.

Also in Products

Getting Notification of Outages

By Jason Riley | Jul 17, 2014

To ensure you receive timely notification of issues, outages and status of the Genability API and web applications, we are instituting a new support notification process. We promise you the following:

Canadina Electricity Rates added to our Electricity Rate Database

By Eric Danziger | May 22, 2014

Genability has expanded its tariff coverage to our neighbors up north! We now have Canadian residential and commercial utilities, tariffs, riders and territories available in our Switch and Conduct products.

Calculating Future Utility Costs with Seasonal Electricity Rates

By John Tucker | Mar 5, 2014

Genability has added forecasted seasonal rates to our Solar Savings calculations.  Not to be confused with utility rate inflation (we’ve got some upgrades coming in this area soon), forecasted seasonal rates allow you to use the most...

Better Solar Enery Savings Estimates Using Hawaiian SunZones

By John Tucker | Mar 4, 2014

Solar is an attractive proposition in Hawaii, with great solar irradiance and high utility rates. 1 out of 4 homes in Hawaii has gone solar.  A home in Honolulu that uses 1,000 kWh/month and installs a 5...