---
title: "How to Integrate Samsung Health with the Data SDK (2026)"
canonical: "https://aifitnessapi.com/integrate/samsung-health-api"
cluster: "Integration Guides"
primary_query: "samsung health api"
last_reviewed: "2026-10-17"
description: "Read Samsung Health data on Android with the Samsung Health Data SDK: requirements, developer mode, partnership approval, permissions, data types, errors."
publisher: "AIFitnessAPI — independent, not sponsored"
cite_as: "\"How to Integrate Samsung Health with the Data SDK (2026)\", AIFitnessAPI, https://aifitnessapi.com/integrate/samsung-health-api"
---

# How to Integrate Samsung Health with the Data SDK (2026)

> To read Samsung Health data, including what a Galaxy Watch or Galaxy Ring syncs to the phone, you use the Samsung Health Data SDK, an Android library that reads the Samsung Health app's data store with the user's per-data-type permission. It needs Samsung Health 6.30.2 or later, Android 10 or later and a real device. During development it works in Samsung Health's developer mode; to release an app you submit a partnership request so Samsung registers your package name and SHA-256 signature, and writing data needs an access code issued after approval. Samsung deprecated its older Samsung Health SDK for Android on July 31, 2025.

- Canonical: https://aifitnessapi.com/integrate/samsung-health-api
- Last reviewed: 2026-10-17
- Publisher: AIFitnessAPI (https://aifitnessapi.com) — independent, not sponsored
- Cite as: "How to Integrate Samsung Health with the Data SDK (2026)", AIFitnessAPI, https://aifitnessapi.com/integrate/samsung-health-api

---

On Samsung's developer site, the way to Samsung Health data is the **Samsung Health Data SDK**, an Android library that lets your app read, and with approval write, selected data in the Samsung Health app's data store on the user's phone. That store also holds data from connected devices: Samsung says a Galaxy Watch or Galaxy Ring automatically transfers its data to the paired phone's Samsung Health app, and lists Galaxy Fit, blood glucose monitors and weight scales among the accessories. Everything below is from Samsung's developer site as read on October 17, 2026. For the comparable Google platform, see [Google Health Connect](/integrate/google-health-connect).

Samsung has two other health SDKs that this guide does not cover: the older **Samsung Health SDK for Android**, which Samsung deprecated as of July 31, 2025 in favor of the Data SDK, and the **Samsung Health Sensor SDK**, which runs on Galaxy Watch4 and later and exposes raw sensor signals such as accelerometer, ECG and PPG to watch apps.

## Access and approval

| Stage | What Samsung's pages say |
|---|---|
| Develop | Download the SDK and turn on developer mode in Samsung Health; developer mode is for testing and debugging only |
| Read in a released app | Submit a partnership request before distribution; after approval, your app's package name and SHA-256 signature are registered in Samsung Health's system |
| Write data | Request partnership; after approval you get an access code for writing, valid for one application |
| Without approval | An app using the SDK works only with developer mode turned on |

Samsung describes the partnership as "an exclusive service for the Samsung Health Data SDK that allows users to discover engaging health and fitness apps". Its pages do not mention fees.

## Requirements

- Samsung Health version 6.30.2 or later on the phone; the SDK needs Samsung Health installed.
- Android 10 (API level 29) or later. Samsung Health runs on all Samsung smartphones and on non-Samsung Android phones.
- Java 17 or later.
- A real device: the SDK does not support emulators.
- Samsung says data measured using the SDK is for fitness and wellness purposes only, not for diagnosing or treating any medical condition.

The version on Samsung's download page on October 17, 2026 was Samsung Health Data SDK v1.1.0, shipped as an `.aar` library you add to your module.

## Permissions

Each data type has its own permission, with read and write separate, and the user grants them in a Samsung Health pop-up. Check what is already granted when your app starts, and request the rest:

```kotlin
// Names from Samsung's Health Data SDK code lab
val store = HealthDataService.getStore(applicationContext)
val permissions = setOf(
    Permission.of(DataTypes.STEPS, AccessType.READ),
    Permission.of(DataTypes.STEPS_GOAL, AccessType.READ),
)
if (!store.getGrantedPermissions(permissions).containsAll(permissions)) {
    store.requestPermissions(permissions, activity)
}
```

Samsung's guidance is not to repeat a request the user keeps denying, and to explain in your settings screen how to allow it in Samsung Health instead.

## Data: what you can read and write

| Direction | Data types Samsung lists |
|---|---|
| Read | Activity summary, active calories burned goal, active time goal, blood glucose, blood oxygen, blood pressure, body composition, body temperature, energy score, exercise, exercise location, floors climbed, heart rate, irregular heart rhythm notification, nutrition, nutrition goal, skin temperature, sleep, sleep apnea, sleep goal, steps, step goal, water intake, water intake goal, user profile |
| Write | Blood glucose, blood oxygen, blood pressure, body composition, body temperature, exercise, exercise location, floors climbed, heart rate, nutrition, sleep, water intake |

Queries can filter and aggregate. Samsung's code lab totals today's steps with an `AggregateRequest` on `DataType.StepsType.TOTAL` and a `LocalTimeFilter`, and groups by hour with a `LocalTimeGroup`; groupings run from `MINUTELY` to `YEARLY`. The aggregate functions combine sources for you, for example total steps from several devices, and only periods with a non-zero step count come back.

```kotlin
val request = DataType.StepsType.TOTAL.requestBuilder
    .setLocalTimeFilter(LocalTimeFilter.of(startOfDay, now))
    .build()
val total = store.aggregateData(request).dataList.firstOrNull()?.value ?: 0L
```

Two other features matter for sync. `HealthDataStore.readChanges()` returns what changed for a data type and time filter: new, updated or deleted data, with the deleted data's ID or the new data point and the change time. And every data point carries its source device, so `DeviceManager.getDevice(deviceId)` tells you whether a value came from a Galaxy Watch, Galaxy Ring, Galaxy Fit, the phone or an accessory.

## Errors you will meet

| Error | Meaning and fix, per Samsung's FAQ |
|---|---|
| `2003: Permission not allowed due to SDK policy` | The app's package name or SHA-256 signature does not match what Samsung registered; submit a partner request with the right values, or use developer mode while developing |
| `PLATFORM_NOT_INSTALLED`, `OLD_VERSION_PLATFORM` | Samsung Health is missing or too old; `ResolvablePlatformException.resolve(activityContext)` sends the user to the store page |
| `ERR_NO_USER_PERMISSION` | The user has not granted the data permission; call `requestPermissions` |
| `ERROR_ACCESS_CONTROL` | The data type is outside the scope available to your app; ask Samsung's developer support |

## Webhooks and rate limits

Samsung's pages describe no push notifications and no request limits for the Data SDK, which reads from the Samsung Health app on the same phone. To find what is new since your last read, use `readChanges()`.

## What changed recently

| When | Change (Samsung's pages) |
|---|---|
| July 31, 2025 | Samsung Health SDK for Android deprecated; Samsung points developers to the Samsung Health Data SDK |
| Seen October 17, 2026 | Samsung Health Data SDK v1.1.0 on the download page, requiring Samsung Health 6.30.2 or later |

## Gotchas and production notes

- **Android, on the phone.** The Data SDK reads Samsung Health on the user's Android phone; the Samsung pages we read describe no iOS SDK or cloud API for this data.
- **Partnership before release.** Without registration your app works only in developer mode, so plan the partner request into your launch.
- **Writes need an access code.** Request it through the same partnership process.
- **Galaxy Ring and Watch data arrive through the phone.** Your app reads them from Samsung Health once the wearable has synced.
- **Wellness, not diagnosis.** Samsung's own limitation applies to anything you build.

The rest of the cluster is at [how to integrate a fitness or health API](/integrate).

## Sources

- [developer.samsung.com/health/data/overview.html](https://developer.samsung.com/health/data/overview.html) — what the Data SDK is, Galaxy Watch and Ring data, read and write data types, limitations, SDK version (checked 2026-10-17)
- [developer.samsung.com/health/data/process.html](https://developer.samsung.com/health/data/process.html) — developer mode, access code for writing, partnership request before distribution (checked 2026-10-17)
- [developer.samsung.com/health/data/faq.html](https://developer.samsung.com/health/data/faq.html) — devices, accessories, errors, permissions guidance, readChanges, source devices, writing data (checked 2026-10-17)
- [developer.samsung.com/codelab/health/steps-data.html](https://developer.samsung.com/codelab/health/steps-data.html) — permissions, aggregate requests, time filters and grouping (checked 2026-10-17)
- [developer.samsung.com/health/android/overview.html](https://developer.samsung.com/health/android/overview.html) — the older Samsung Health SDK for Android, deprecated July 31, 2025 (checked 2026-10-17)
- [developer.samsung.com/health/sensor/overview.html](https://developer.samsung.com/health/sensor/overview.html) — the Samsung Health Sensor SDK for Galaxy Watch (checked 2026-10-17)

## FAQ

### Does Samsung Health have an API?

Samsung offers the Samsung Health Data SDK, an Android library that lets an app read selected health data from the Samsung Health app's data store on the user's phone and, with approval, write some types. The older Samsung Health SDK for Android was deprecated on July 31, 2025, and Samsung points developers to the Data SDK.

[Permalink](https://aifitnessapi.com/integrate/samsung-health-api#faq-1)

### Can I read Galaxy Ring data through Samsung Health?

Yes, through the phone. Samsung says a Galaxy Watch or Galaxy Ring automatically transfers its data to the paired phone's Samsung Health app, where the Data SDK can read it, and each data point names its source device, so you can tell ring data from watch or phone data with DeviceManager.getDevice.

[Permalink](https://aifitnessapi.com/integrate/samsung-health-api#faq-2)

### Do I need Samsung's approval to use the Samsung Health Data SDK?

To release an app, yes. During development the SDK works with Samsung Health's developer mode on. Before distribution you submit a partnership request, and after approval Samsung registers your app's package name and SHA-256 signature; without that, the SDK only works in developer mode. Writing data needs an access code issued after approval.

[Permalink](https://aifitnessapi.com/integrate/samsung-health-api#faq-3)

### What does error 2003 mean in the Samsung Health Data SDK?

Samsung's FAQ says 2003, Permission not allowed due to SDK policy, means your app's package name or SHA-256 signature does not match what is registered with Samsung. Submit a partner request with the correct values, or enable developer mode to keep developing without registration.

[Permalink](https://aifitnessapi.com/integrate/samsung-health-api#faq-4)

### Which devices does the Samsung Health Data SDK run on?

Android 10 (API level 29) or later with Samsung Health 6.30.2 or later installed. Samsung says Samsung Health runs on all Samsung smartphones and on non-Samsung Android phones. The SDK needs Java 17 or later and does not support emulators.

[Permalink](https://aifitnessapi.com/integrate/samsung-health-api#faq-5)