Raw HealthKit

Raw HealthKit endpoints require a second in-app consent in addition to the base Developer Mode terms and client pairing.

Requirements

Raw HealthKit reads require all of the following:

• Developer Mode is enabled.
• Developer Mode terms are accepted.
• Raw HealthKit API consent is accepted in the app.
• The paired client has the healthkit.raw scope.
• SuperAge already has the relevant Apple Health permission.

Type Availability

Use /api/v1/healthkit/types to see supported types and whether each type is available and readable.

curl --request GET \
  --url "<LAN_API_URL>/api/v1/healthkit/types" \
  --header "Authorization: Bearer <TOKEN>"

Samples

Use /api/v1/healthkit/samples with type, start, and end.

curl --request GET \
  --url "<LAN_API_URL>/api/v1/healthkit/samples?type=heartRate&start=2026-06-01T00:00:00Z&end=2026-06-02T00:00:00Z&limit=100" \
  --header "Authorization: Bearer <TOKEN>"

If permission is missing, the endpoint returns 403 permission_denied.