FAQ

Samsung Health has various features to measure the health data of users. It allows for automatically measuring vital signs and recording activities with connected accessories. These accessories include Galaxy Watch, Galaxy Fit, Galaxy Ring, a blood glucose monitor, and a weight scale. Users can track, for example, their daily steps, heart rate, sleep, nutrition, and other data. Managing a healthy lifestyle is easier and simpler with Samsung Health.

The Samsung Health Data SDK allows Android applications to read selected health data from Samsung Health’s data store. You can use this data to build custom applications related to such interests as general health monitoring, improving sleep conditions, tracking progress of physical activity, and more.

You can access the Samsung Health Data SDK library download and documentation from: here

The Samsung Health Data SDK runs on devices with Android 10 (API level 29) or above. It is available on all Samsung smartphones and non-Samsung phones.
The Samsung Health application has the same device requirements.
The Samsung Health Data SDK requires prior Samsung Health installation.

More information about the limitations is available here.

An application using the Samsung Health Data SDK can read saved health data in Samsung Health, such as steps, exercise, and sleep data.
All available health data are listed here.

If you see this error, please check that your application package name registration and the distributed application’s signature (SHA-256) are the same with your request to the Samsung Health team. If they are the same, you can ask for an information change at Samsung developer site > Support > Developer support.

Additionally, for application testing purposes, please use the developer mode of the Samsung Health Data SDK. It can be enabled in Samsung Health; for more information, see here.

The Samsung Health Data SDK runs with the Samsung Health application. If the Samsung Health application is not installed or the installed version is too old, the Samsung Health Data SDK gives the following exceptions:

PLATFORM_NOT_INSTALLED occurs if the Samsung Health application is not installed on the phone.

OLD_VERSION_PLATFORM occurs when the installed Samsung Health version is older than required by the Samsung Health Data SDK.

It can be resolved by invoking ResolvablePlatformException.resolve(activityContext).

This API enables your application to jump to the right market page to install or update the Samsung Health application.

Accessing Samsung Health’s data requires the user’s agreement for the SDK data permissions.

You can resolve this error by calling one of the following APIs with the necessary data permissions for your application:

HealthDataStore.requestPermissions(Set<Permission>, Activity)
HealthDataStore.requestPermissionsAsync(Set<Permission>, Activity)

These APIs display a data permission pop-up to the user and the user can then allow each data permission.

Avoid annoying the user with endlessly repeating permission requests. If the user denies few times, stop requesting permissions. Instead, provide a proper guide message with your application setting menu information to let them know they should allow data permissions with Samsung Health.

It means that the data type is not included in the available data scope for your application. To solve this issue, please submit your query at the Samsung developer site > Support > Developer support.

The Health team will check your query and reply.

Each data point has data source information including the device ID indicating which device provided the health data. You can retrieve the source device’s details:

DeviceManager.getDevice(deviceId: String): Device

The DataType in the device’s details can be a Galaxy Watch, Galaxy Ring, Galaxy Fit, a smartphone, or a health accessory device. You can use this information to filter data points.

New or deleted data can be checked on demand. Each time the application invokes the readChange API, the modified data will be returned.
HealthDataStore.readChanges() and HealthDataStore.readChangesAsync() provide data change information for a given data type and a time filter.

These APIs give:

  • A change type indicating new, updated, or deleted data
  • A data ID if the data has been deleted
  • A data point for new or updated data
  • A changed time

For now, Samsung Health Data enables operations for reading data from the Samsung Health application and reading changes.

An insert feature will be provided in future versions of the Samsung Health Data SDK.