API Documentation

Getting started with the Oura Cloud API

The Oura Cloud API makes it easy to access rich sleep, activity and readiness data generated by the Oura ring. To use the Oura Cloud API, you need an Oura account and an API application.

Create an Oura account

Create an Oura account using the Oura iOS or Android application. Use the same account to sign-in to https://cloud.ouraring.com.

Create an API application

Before using the Oura Cloud API, you'll need to register a new OAuth2 application under API Applications. Give your application a name and website that describes your integration. If you are only creating the application to download your own data, you do not need to give a valid description or homepage.

A registered OAuth application is assigned a unique Client ID and Client Secret. The Client Secret should not be shared.

Once you have finished developing your application and want to release it to a wider audience, your application needs to be approved. Until it is approved, your application has a ten user limit but is otherwise fully functional. You can submit your application for review from the application's page.

Note: if you are only creating the application to access your own data, you do not need to give a valid description or homepage and do not need to get your app approved.