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 either a Personal Access Token or an API application.

1. Create an Oura account

If you don't already have one, create an Oura account using the Oura iOS or Android application. Use the same account to sign-in to https://cloud.ouraring.com.

2a. Create a Personal Access Token

If you only want to access your own data, the easiest option is to create a personal access token. Learn more from the Authentication section.

2b. Create an API application

If you want to use the Oura API to pull data from multiple users, you'll need to register a new OAuth2 application under API Applications. Give your application a name and website that describes your integration.

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

By default, API Applications have a ten user limit. If you want to release your application to a wider audience, your application needs to be approved. Once you have finished developing your application, you can submit it for review from the application's page.