Availability

In general, we try to always give you the most up-to-date information. Even if we are the middle of collecting data for a new object, you can still request all the data that we've collected so far. That way, you can start doing the stuff you need to do as soon as possible.

For example, when you trigger a historical collection job via the API, we go and collect the bill and usage data for the meters you included. If this is hundreds of meters, this historical collection job may take a while. However, as we collect data for individual meters you will see their bill_count and interval_count tick up and you will be able to download the bills for those meters even though the overall historical collection job is still "pending".

We also try not to limit the number of times you download your data. However, if you are spamming downloads that's putting a burden on our servers, we may rate limit how many times you can request that data per hour. You will see a HTTP response code of 429 when you are being rate limited.

As a general rule, please try to not GET request bill and interval downloads more than once per minute, and all other GET and POST requests once per second. If you need more throughput than that, please let us know and we will work with you to make it happen!