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
Authorization*
string
Basic <ProjectId>:<API-Key>
Query Parameters
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
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
{
"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
Authorization*
string
Basic <ProjectId>:<API-Key>
Request Body
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
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)
{
"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 }
]
}
]
}Last updated