Batch Query

Activities
/apps/:clientId/users/activities

Activity Summaries
/apps/:clientId/users/activities/summaries

Heart Rates
/apps/:clientId/users/heart_rates

BMIs
/apps/:clientId/users/bmis

Body Fats
/apps/:clientId/users/body_fats

Heights
/apps/:clientId/users/heights

Weights
/apps/:clientId/users/weights

Blood Glucoses
/apps/:clientId/users/blood_glucoses

Blood Oxygens
/apps/:clientId/users/blood_oxygens

Blood Pressures
/apps/:clientId/users/blood_pressures

Genetic Traits
/apps/:clientId/users/genetic_traits

Locations
/apps/:clientId/users/locations

Meals
/apps/:clientId/users/food/meals

Sleeps
/apps/:clientId/users/sleeps

Sleep Summaries
/apps/:clientId/users/sleeps/summaries

📘
Do not perform regular batch queries without the updated_since query parameter. By supplying updated_since with your last query time, you can ensure that your queries are quick and efficient.
For a more detailed description of batch queries including best practices, see the documentation.

Query Parameters

Parameter	Type	Description
updated_since	Date in YYYYMMDDTHHmmssZ format.	Use this in order to retrieve only the new data since your last query.

# Get activities for all of your users
curl -X GET -H 'Accept: application/json' \
    -u e7db255f4828e1d482743eba04faacb945ab7ca8: \
https://api.humanapi.co/v1/apps/1d129c20acf6fcef9be0b067cc7859d872ed5ade/users/activities

# Returns a json array of activities
[
  {
    "id": "52867cbfde3155565f000b01",
    "userId": "51cc7cb31a154bf215000002",
    "humanId": "7eddd553c81b8de9ac271bc21f50e32e",
    "startTime": "2013-11-01T17:27:00.346Z",
    "endTime": "2013-11-01T18:27:11.346Z",
    "type": "walking",
    "source": "runkeeper",
    "duration": 3611,
    "distance": 1251,
    "steps": 2689,
    "calories": 482,
    "timeZone": "America/Los_Angeles",
    "sourceData": {},
    "timeSeries": {},
    "createdAt": "2013-11-01T17:27:00.346Z",
    "updatedAt": "2013-11-01T17:27:00.346Z"
  },
  {
    "id": "52867cbfde3155565f000b02",
    "userId": "538b9d3a9b1e35be7302607e",
    "humanId": "7eddd553c81b8de9ac271bc21f50e32e",
    "startTime": "2014-05-31T16:18:19.000Z",
    "endTime": "2014-05-31T19:00:27.000Z",
    "type": "cycling",
    "source": "strava",
    "duration": 9728,
    "distance": 45468.6,
    "steps": 0,
    "calories": 0,
    "sourceData": {
      "maxHeartrate": 196,
      "averageHeartrate": 145,
      "maxSpeed": 17.3,
      "mapId": "a147785724",
      "movingTime": 7782,
      "type": "Ride"
    },
    "createdAt": "2014-05-31T19:03:32.032Z",
    "updatedAt": "2014-05-31T19:03:32.032Z"
  },
  {
    "id": "52867cbfde3155565f000b03",
    "userId": "538029c700850beb2601c578",
    "humanId": "7eddd553c81b8de9ac271bc21f50e32e",
    "startTime": "2014-05-28T20:04:02.000Z",
    "endTime": "2014-05-29T00:00:00.000Z",
    "type": "walking",
    "source": "mapmyfitness",
    "duration": 0,
    "distance": 178636.74,
    "steps": 0,
    "calories": 1916,
    "sourceData": { },
    "createdAt": "2014-05-31T00:21:09.386Z",
    "updatedAt": "2014-05-31T00:21:09.386Z"
  }
]

Response Properties

Property	Type	Description
humanId	String	The id of the user in Human API
externalId	String	The id of the user provided from your application
appId	String	Unique app identifier found in the Developer Portal.
createdAt	Date	The time the measurement was created on the Human API server
updatedAt	Date	The time the measurement was updated on the Human API server