Introduction

Hello developer! Welcome to the Netatmo APIs!

Netatmo designs, produces and distributes beautiful and smart connected objects, for home and beyond.
Those objects connect to the Netatmo server, to upload measured data and receive given orders. Our users can interact with those objects from their Netatmo apps (iOS, Android, webapp...), through the Netatmo server.
Wouldn't it be cool if your app could also do the same? Wait no more: the Netatmo APIs are here for that!

Because you are accessing user's Netatmo devices (private data), we are distinguishing several APIs for several uses, which allow your application to interact with those devices:

  • The Netatmo REST PRIVATE API allows a third party application (your application) to access a specific device (the device) once the owner of the device (the user) has granted access to the application. The methods of the PRIVATE API allows the application to read all data (indoor, outdoor) of the device and perform actions (for example setup temperature setpoint).
    Granting access is performed using OAuth 2.0 with either the Authorization Code Grant call flow or the Resource Owner Password Credentials Grant call flow.
  • The Netatmo REST PUBLIC API allows your application to read data of a device which has been previously set as "public" by its owner (for example outdoor data such as temperature, pressure, humidity and rain).
  • The Netatmo REST PARTNER API allows your application to interact with a large set of devices, distributed with bundled services.

Your application can be located anywhere on the internet, running on a server or on a terminal.
The Netatmo REST APIs uses HTTP POST and GET methods and all HTTP responses are JSON encoded.

To get started you can either:

  • Get more information about Netatmo devices.
  • Get a grasp of the basic functioning of the API and different methods, with clear diagrams.
  • Look at the Oauth 2.0 implementation, with detailed examples.
  • Read the complete description of each method available in this API.
  • Jump directly to our SDK section.
  • Get help from others, with the FAQ / Forum.

When you are ready, sign in with a Netatmo account, and create an app.