Getting started with the Oura API V1
The Oura API makes it easy to access data generated by the Oura Ring.
To use the Oura API, you need an Oura account and either a
Personal Access Token
or an API application.
This documentation is for the Oura API V1. Click here to view documentation for the Oura API V2,
which includes additional data types and functionality.
For more information on rate limiting see the V2 documentation here.
API V1 Deprecation
The current timeline to sunset the Oura API V1 is early 2023.
We are not planning any updates—outside of required maintenance—to the
Oura API V1 moving forward. A migration guide for users to transition
from V1 to V2 of the Oura API will be available in February 2022.
1. Create an Oura account
If you don't already have one, create an Oura account using the Oura
application. Use the same account to sign-in to
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
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.