PHPackages stoufa06/php-garmin-connect-api - 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. stoufa06/php-garmin-connect-api ActiveLibrary[API Development](/categories/api) stoufa06/php-garmin-connect-api =============================== PHP library to connect and use garmin wellness api 1.10(1y ago)1614.9k↓25.9%12[1 issues](https://github.com/stoufa06/php-garmin-connect-api/issues)MITPHPPHP >=7.1 Since Jun 22Pushed 1y ago8 watchersCompare [ Source](https://github.com/stoufa06/php-garmin-connect-api)[ Packagist](https://packagist.org/packages/stoufa06/php-garmin-connect-api)[ RSS](/packages/stoufa06-php-garmin-connect-api/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (6)Dependencies (2)Versions (13)Used By (0) Table of contents ================= [](#table-of-contents) - [Table of contents](#table-of-contents) - [Description](#description) - [Installtion](#installtion) - [Example](#example) - [Usage](#usage) - [Get authorization link](#get-authorization-link) - [Get token credentials](#get-token-credentials) - [Get Garmin user id](#get-garmin-user-id) - [Backfill activities](#backfill-activities) - [Deregistration](#deregistration) - [Avalaible methods (for the moment)](#avalaible-methods-for-the-moment) - [Get summary activities](#get-summary-activities) - [Backfill activities](#backfill-activities-1) Description =========== [](#description) PHP library to connect and use garmin wellness api Installtion =========== [](#installtion) ``` composer require stoufa06/php-garmin-connect-api ``` Example ======= [](#example) Please take a look at [examples](./examples/README.md) folder Usage ===== [](#usage) Get authorization link ---------------------- [](#get-authorization-link) ``` use Stoufa\GarminApi\GarminApi; try { $config = array( 'identifier' => getenv('GARMIN_KEY'), 'secret' => getenv('GARMIN_SECRET'), 'callback_uri' => getenv('GARMIN_CALLBACK_URI') ); $server = new GarminApi($config); // Retreive temporary credentials from server $temporaryCredentials = $server->getTemporaryCredentials(); // Save temporary crendentials in session to use later to retreive authorization token $_SESSION['temporaryCredentials'] = $temporaryCredentials; // Get authorization link $link = $server->getAuthorizationUrl($temporaryCredentials); } catch (\Throwable $th) { // catch your exception here } ``` Get token credentials --------------------- [](#get-token-credentials) After the user connects his garmin account successfully it will redirect to callback\_uri. "oauth\_token" and "oauth\_verifier" should be available in $\_GET. ``` try { $config = array( 'identifier' => getenv('GARMIN_KEY'), 'secret' => getenv('GARMIN_SECRET'), 'callback_uri' => getenv('GARMIN_CALLBACK_URI') ); $server = new GarminApi($config); // Retrieve the temporary credentials we saved before $temporaryCredentials = $_SESSION['temporaryCredentials']; // We will now retrieve token credentials from the server. $tokenCredentials = $server->getTokenCredentials($temporaryCredentials, $_GET['oauth_token'], $_GET['oauth_verifier']); } catch (\Throwable $th) { // catch your exception here } ``` Get Garmin user id ------------------ [](#get-garmin-user-id) ``` $userId = $server->getUserUid($tokenCredentials); ``` Backfill activities ------------------- [](#backfill-activities) When you connect garmin account and get token credentials first time, you won't be able to get previous activities because garmin does not give you activities older than your token credentials. Instead you need to use backfill method to fullfull your token with previous activities (no more than one month). ``` // backfill activities for last 7 days ago $params = [ 'summaryStartTimeInSeconds' => strtotime("-7 days", time()), 'summaryEndTimeInSeconds' => time() ]; $server->backfillActivitySummary($tokenCredentials, $params); ``` Deregistration -------------- [](#deregistration) ``` $server->deleteUserAccessToken($tokenCredentials); ``` Avalaible methods (for the moment) ---------------------------------- [](#avalaible-methods-for-the-moment) ### Get summary activities [](#get-summary-activities) ``` $params = [ 'uploadStartTimeInSeconds' => 1598814036, // time in seconds utc 'uploadEndTimeInSeconds' => 1598900435 // time in seconds utc ]; // Activity summaries $server->getActivitySummary($tokenCredentials, $params); // Manually activity summaries $server->getManuallyActivitySummary($tokenCredentials, $params); // Activity details summaries $server->getActivityDetailsSummary($tokenCredentials, $params); ``` ### Backfill activities [](#backfill-activities-1) ``` // For backfill params can be with upload start time $params = [ 'uploadStartTimeInSeconds' => 1598814036, // time in seconds utc 'uploadEndTimeInSeconds' => 1598900435 // time in seconds utc ]; // or with summary start time $params = [ 'summaryStartTimeInSeconds' => 1598814036, // time in seconds utc 'summaryEndTimeInSeconds' => 1598900435 // time in seconds utc ]; // Backfill activity summaries $server->backfillActivitySummary($tokenCredentials, $params); // Backfill daily activity summaries $server->backfillDailySummary($tokenCredentials, $params); // Backfill epoch summaries $server->backfillEpochSummary($tokenCredentials, $params); // Backfill activity details summaries $server->backfillActivityDetailsSummary($tokenCredentials, $params); // Backfill sleep summaries $server->backfillSleepSummary($tokenCredentials, $params); // Backfill body composition summaries $server->backfillBodyCompositionSummary($tokenCredentials, $params); // Backfill stress details summaries $server->backfillStressDetailsSummary($tokenCredentials, $params); // Backfill user metrics summaries $server->backfillUserMetricsSummary($tokenCredentials, $params); // Backfill pulse ox summaries $server->backfillPulseOxSummary($tokenCredentials, $params); // Backfill respiration summaries $server->backfillRespirationSummary($tokenCredentials, $params); ``` ### Health Score 41 — FairBetter than 89% of packages Maintenance44 Moderate activity, may be stable Popularity36 Limited adoption so far Community16 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 97.3% 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 ~193 days Recently: every ~416 days Total 10 Last Release 417d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/dc71504a4c9df30220a909080517e48dc1e4d10745e9c8d28ede075506445b90?d=identicon)[stoufa06](/maintainers/stoufa06) --- Top Contributors [![stoufa06](https://avatars.githubusercontent.com/u/3877384?v=4)](https://github.com/stoufa06 "stoufa06 (36 commits)")[![COil](https://avatars.githubusercontent.com/u/177844?v=4)](https://github.com/COil "COil (1 commits)") --- Tags phpapigarmingarmin-connect ### Embed Badge ![Health badge](/badges/stoufa06-php-garmin-connect-api/health.svg) ``` [![Health](https://phpackages.com/badges/stoufa06-php-garmin-connect-api/health.svg)](https://phpackages.com/packages/stoufa06-php-garmin-connect-api) ``` ### Alternatives [jstolpe/instagram-graph-api-php-sdk Instagram Graph API PHP SDK 13998.4k2](/packages/jstolpe-instagram-graph-api-php-sdk) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)