PHPackages                             tai-sho/oura-api-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. tai-sho/oura-api-php

ActiveLibrary[API Development](/categories/api)

tai-sho/oura-api-php
====================

A PHP client library for the Oura Ring API

v1.0.1(1y ago)011[1 PRs](https://github.com/tai-sho/oura-api-php/pulls)MITPHPPHP >=7.4

Since Jun 8Pushed 1y ago1 watchersCompare

[ Source](https://github.com/tai-sho/oura-api-php)[ Packagist](https://packagist.org/packages/tai-sho/oura-api-php)[ RSS](/packages/tai-sho-oura-api-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (7)Versions (4)Used By (0)

oura-api-php
============

[](#oura-api-php)

[![Latest Stable Version](https://camo.githubusercontent.com/7bd07d8bd1808cd8cbc3401abd574113f56d52c046f715e9b66ebfa4b8f4c211/68747470733a2f2f706f7365722e707567782e6f72672f7461692d73686f2f6f7572612d6170692d7068702f762f737461626c65)](https://packagist.org/packages/tai-sho/oura-api-php)[![Build Status](https://github.com/tai-sho/oura-api-php/actions/workflows/code_check.yml/badge.svg)](https://github.com/tai-sho/oura-api-php/actions/workflows/code_check.yml)[![Coverage Status](https://camo.githubusercontent.com/26093d5b6b303e4bf20c1deb8fc3c7fa83d18675f120edd06f22987a43e54688/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f7461692d73686f2f6f7572612d6170692d7068702f62616467652e7376673f6272616e63683d6d61696e)](https://coveralls.io/github/tai-sho/oura-api-php?branch=main)[![PHP Version](https://camo.githubusercontent.com/7404ac2849f95f99ace60c4b949c4e57e3188dfc0d5df7a913378138ac571fb6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344372e342d626c7565)](https://packagist.org/packages/tai-sho/oura-api-php)[![License](https://camo.githubusercontent.com/e8b81ade5fa80af1ddf411ac55288a2282158694c239b4a72f7587851cb2c47b/68747470733a2f2f706f7365722e707567782e6f72672f7461692d73686f2f6f7572612d6170692d7068702f6c6963656e7365)](https://packagist.org/packages/tai-sho/oura-api-php)[![Twitter Follow](https://camo.githubusercontent.com/261af0aedbd9e4a14efb1ffdb486bde9b05c996b25f254b828b32e9e8a8b7c2c/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f666f6c6c6f772f53686f6865695461692e7376673f7374796c653d736f6369616c266c6162656c3d466f6c6c6f77)](https://twitter.com/ShoheiTai)

A PHP client library for the Oura Ring API.

Requirements
------------

[](#requirements)

- PHP 7.4 or higher
- Composer
- Oura Personal Access Token (see below for more information)

Installation
------------

[](#installation)

You can install the library via Composer. Run the following command:

```
$ composer require tai-sho/oura-api-php
```

Usage
=====

[](#usage)

Personal Access Token
---------------------

[](#personal-access-token)

This library requires a personal access token to authenticate with the Oura API. You can obtain a personal access token from the Oura page: [Oura API Doc](https://cloud.ouraring.com/docs)

Initialization
--------------

[](#initialization)

First, you need to initialize the client with your API access token.

```
require 'vendor/autoload.php';

use OuraApiPhp\Client;

$accessToken = 'your-access-token';
$client = new Client($accessToken);
```

Examples
--------

[](#examples)

### Get Heart Rate Data

[](#get-heart-rate-data)

```
$params = ['start_date' => '2024-01-01', 'end_date' => '2024-01-07'];
$response = $client->getHeartRate($params);
$data = json_decode($response->getBody()->getContents(), true);
print_r($data);
```

### Get Personal Info

[](#get-personal-info)

```
$response = $client->getPersonalInfo();
$data = json_decode($response->getBody()->getContents(), true);
print_r($data);
```

### Get Workout Data

[](#get-workout-data)

```
$params = ['start_date' => '2024-01-01', 'end_date' => '2024-01-07'];
$response = $client->getWorkout($params);
$data = json_decode($response->getBody()->getContents(), true);
print_r($data);
```

### Get All Heart Rate Data (Handling Pagination)

[](#get-all-heart-rate-data-handling-pagination)

```
$params = ['start_date' => '2024-01-01', 'end_date' => '2024-01-07'];
$responses = $client->getAllHeartRateData($params);
foreach ($responses as $response) {
    $data = json_decode($response->getBody()->getContents(), true);
    print_r($data);
}
```

Available Endpoints
-------------------

[](#available-endpoints)

The client supports the following endpoints:

- `getHeartRate(array $params = [])`
- `getPersonalInfo(array $params = [])`
- `getTag(array $params = [])`
- `getEnhancedTag(array $params = [])`
- `getWorkout(array $params = [])`
- `getSession(array $params = [])`
- `getDailyActivity(array $params = [])`
- `getDailySleep(array $params = [])`
- `getDailySpo2(array $params = [])`
- `getDailyReadiness(array $params = [])`
- `getSleep(array $params = [])`
- `getSleepTime(array $params = [])`
- `getRestModePeriod(array $params = [])`
- `getRingConfiguration(array $params = [])`
- `getDailyStress(array $params = [])`
- `getTagById(string $documentId, array $params = [])`
- `getEnhancedTagById(string $documentId, array $params = [])`
- `getWorkoutById(string $documentId, array $params = [])`
- `getSessionById(string $documentId, array $params = [])`
- `getDailyActivityById(string $documentId, array $params = [])`
- `getDailySleepById(string $documentId, array $params = [])`
- `getDailySpo2ById(string $documentId, array $params = [])`
- `getDailyReadinessById(string $documentId, array $params = [])`
- `getSleepById(string $documentId, array $params = [])`
- `getSleepTimeById(string $documentId, array $params = [])`
- `getRestModePeriodById(string $documentId, array $params = [])`
- `getRingConfigurationById(string $documentId, array $params = [])`
- `getDailyStressById(string $documentId, array $params = [])`

Get All Data Functions (Handling Pagination)
--------------------------------------------

[](#get-all-data-functions-handling-pagination)

- `getAllHeartRateData(array $params = [])`
- `getAllWorkoutData(array $params = [])`
- `getAllTagData(array $params = [])`
- `getAllEnhancedTagData(array $params = [])`
- `getAllSessionData(array $params = [])`
- `getAllDailyActivityData(array $params = [])`
- `getAllDailySleepData(array $params = [])`
- `getAllDailySpo2Data(array $params = [])`
- `getAllDailyReadinessData(array $params = [])`
- `getAllSleepData(array $params = [])`
- `getAllSleepTimeData(array $params = [])`
- `getAllRestModePeriodData(array $params = [])`
- `getAllRingConfigurationData(array $params = [])`
- `getAllDailyStressData(array $params = [])`

Contributing
============

[](#contributing)

Welcome contributions! Please submit a pull request or open an issue to discuss changes.

License
=======

[](#license)

This project is licensed under the MIT License. See the [LICENSE](https://github.com/tai-sho/oura-api-php/blob/main/LICENSE) file for details.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance35

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

700d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3de7989abd10c12d2611602143e8bf885e0de0475bae19a2bef4ec72b897a469?d=identicon)[tai-sho](/maintainers/tai-sho)

---

Top Contributors

[![tai-sho](https://avatars.githubusercontent.com/u/6727558?v=4)](https://github.com/tai-sho "tai-sho (39 commits)")

---

Tags

api-clientoura-api-v2oura-cloud-apioura-ringphp

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/tai-sho-oura-api-php/health.svg)

```
[![Health](https://phpackages.com/badges/tai-sho-oura-api-php/health.svg)](https://phpackages.com/packages/tai-sho-oura-api-php)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M648](/packages/sylius-sylius)[theodo-group/llphant

LLPhant is a library to help you build Generative AI applications.

1.5k311.5k5](/packages/theodo-group-llphant)[yoti/yoti-php-sdk

Yoti SDK for quickly integrating your PHP backend with Yoti

27539.9k1](/packages/yoti-yoti-php-sdk)[vin-sw/shopware-sdk

A PHP SDK for Shopware 6 Platform

122469.3k6](/packages/vin-sw-shopware-sdk)[commercetools/commercetools-sdk

The official PHP SDK for the commercetools Composable Commerce APIs

19281.5k](/packages/commercetools-commercetools-sdk)[mozex/anthropic-php

Anthropic PHP is a supercharged community-maintained PHP API client that allows you to interact with Anthropic API.

46365.1k13](/packages/mozex-anthropic-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)