Move Health API

Fetch steps

GET https://sdk.dolph.in/v20/health/steps

Retrieves a user's step count within a specified time range, including the total number of steps as well as a breakdown per device.

Headers

Name	Type	Description
Authorization*	string	Basic <ProjectId>:<API-Key>

Query Parameters

Name	Type	Description
userId*	string	The user id
projectId*	integer	Id of MOVE SDK project
from*	integer	Start of the time range (Unix epoch timestamp in seconds)
to*	integer	End of the time range (Unix epoch timestamp in seconds)

Response Body

Name	Type	Description
total	integer	Aggregated step count from all devices.
devices	array	List of individual device contributions, each with:
from	integer	Start of the time range (Unix epoch timestamp in seconds)
to	integer	End of the time range (Unix epoch timestamp in seconds)
devices.name	string	Name of device
devices.total	integer	Step count reported by the device

200

{
  "total": 12312,
  "devices": [
    {
      "name": "Apple Watch",
      "total": 10112
    },
    {
      "name": "Apple iPhone",
      "total": 5400
    }
  ]
}

Fetch steps (batch)

POST /v20/health/steps/query

Returns a list of step-count results for one or more users within a specified time range. Each result includes the total number of steps and a per-device breakdown.

Headers

Name	Type	Description
Authorization*	string	Basic <ProjectId>:<API-Key>

Request Body

Name	Type	Description
projectId	integer	Your project identifier
queries.userId	string	The user identifier.
queries.from	integer	Start of the time range (Unix timestamp)
queries.from	integer	End of the time range (Unix timestamp)

{
  "projectId": 12345,
  "queries": [
    {
      "userId": "user_001",
      "from": 1711929600,
      "to": 1712016000
    },
    {
      "userId": "user_002",
      "from": 1711929600,
      "to": 1712016000
    }
  ]
}

Response Body

Name	Type	Description
results.projectId	integer	Echoed project ID
results.userId	string	Echoed user ID
results.total	integer	Total steps in the time range.
results.devices.name	string	Device name (e.g., “Apple Watch”).
results.devices.name	integer	Steps attributed to that device.
results.from	integer	Start of the time range (Unix timestamp)
results.to	integer	End of t he time range(Unix timestamp)

200

{
  "results": [
    {
      "projectId": 12345,
      "userId": "user_001",
      "total": 12312,
      "from": 1711929600
      "to": 1712016000
      "devices": [
        { "name": "Apple Watch", "total": 10112 },
        { "name": "Apple iPhone", "total": 5400 }
      ]
    },
    {
      "projectId": 12345,
      "userId": "user_002",
      "total": 8421,
      "from": 1711929600
      "to": 1712016000
      "devices": [
        { "name": "Apple Watch", "total": 6200 },
        { "name": "Apple iPhone", "total": 3221 }
      ]
    }
  ]
}