Getting Started with the ecobee API

The ecobee API provides an http-based interface for control and access to the ecobee thermostats. Integrators will be allowed to read, update and poll information about their thermostat(s). ecobee aims to be backward compatible with previous versions of the API and to protect implementations from breaking when new features or changes are implemented. The API also strives to be self-documenting, easy to understand and use.

JSON Notation

JSON notation is used for serialization of request/response objects sent to and from the ecobee API. JSON is a lightweight data-interchange format. It is easy for humans to read and write and machines to parse and generate. JSON has become a common, open format, used widely in all manner of web based applications. There are JSON parsers available for almost all development languages.

More information in JSON may be found at

It is important to note that JSONP is not supported at this time.

Back To Top