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.
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.
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.
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.
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.