Heart Rate Zone

This resource provides access to a user’s Heart Rate Zone settings.

Resource URIs

Item URI: /v7.1/heart_rate_zones/{pk}/

Collection URI: /v7.1/heart_rate_zones/

Item

Item Methods

GET Retrieve a Heart Rate Zone by id

Item properties

Name Description Type HTTP Support
created_date Date the setting was created Date GET: required
zones A list of the Heart Rate Zones in this setting json GET: required
Example values

zones

{
    [
    
        {"name": "zone1", "start": integer, "end": integer},
        
        {"name": "zone2", "start": integer, "end": integer},
        
        ...
        
        {"name": "zone5", "start": integer, "end": integer},
    ]
}

self A link to this resource
user A link to the User resource that owns the Heart Rate Zone

Collection

Collection methods

GET Get a list of Heart Rate Zones.
POST Create a Heart Rate Zone.

Collection query parameters

Name Description Type Required
user Either href or id of user string or number Yes

Collection properties

Name Description Type HTTP Support
total_count number of Heart Rate Zone settings number GET: required

self A link to this resource
user A link to the User resource that owns the Heart Rate Zone

Embedded collections

heart_rate_zones A collection of Heart Rate Zone with properties as described under Item properties and links as described under Item links

Usage

GET Heart Rate Zone entity

Request GET: /v7.1/heart_rate_zones/{pk}/
Response
{
   "zones":[
      {
         "start":0,
         "end":80,
         "name":"zone1"
      },
      {
         "start":81,
         "end":100,
         "name":"zone2"
      },
      {
         "start":101,
         "end":120,
         "name":"zone3"
      },
      {
         "start":121,
         "end":140,
         "name":"zone4"
      },
      {
         "start":141,
         "end":160,
         "name":"zone5"
      }
   ],
   "_links":{
      "self":[
         {
            "href":"\/api\/0.1\/heart_rate_zones\/10\/",
            "id":"10"
         }
      ],
      "documentation":[
         {
            "href":"https:\/\/developer.mapmyfitness.com\/docs\/"
         }
      ],
      "user":[
         {
            "href":"\/v7.0\/user\/36\/",
            "id":"36"
         }
      ]
   },
   "created_date":"2014-12-05T21:00:12+00:00"
}

GET Heart Rate Zone collection

Request GET: /v7.1/heart_rate_zones/?user=28
Response
{
   "_links":{
      "self":[
         {
            "href":"\/api\/0.1\/heart_rate_zones\/?limit=20&user=28&offset=0"
         }
      ],
      "documentation":[
         {
            "href":"https:\/\/developer.mapmyfitness.com\/docs\/"
         }
      ]
   },
   "_embedded":{
      "heart_rate_zones":[
        ...
      ]
   },
   "total_count":0
}

POST Heart Rate Zone entity

Request POST: /v7.1/heart_rate_zones/
{
   "zones":[
      {
         "start":0,
         "end":80,
         "name":"zone1"
      },
      {
         "start":81,
         "end":100,
         "name":"zone2"
      },
      {
         "start":101,
         "end":120,
         "name":"zone3"
      },
      {
         "start":121,
         "end":140,
         "name":"zone4"
      },
      {
         "start":141,
         "end":160,
         "name":"zone5"
      }
   ]
}
Response
{
   "zones":[
      {
         "start":0,
         "end":80,
         "name":"zone1"
      },
      {
         "start":81,
         "end":100,
         "name":"zone2"
      },
      {
         "start":101,
         "end":120,
         "name":"zone3"
      },
      {
         "start":121,
         "end":140,
         "name":"zone4"
      },
      {
         "start":141,
         "end":160,
         "name":"zone5"
      }
   ],
   "_links":{
      "self":[
         {
            "href":"\/api\/0.1\/heart_rate_zones\/12\/",
            "id":"12"
         }
      ],
      "documentation":[
         {
            "href":"https:\/\/developer.mapmyfitness.com\/docs\/"
         }
      ],
      "user":[
         {
            "href":"\/v7.0\/user\/38\/",
            "id":"38"
         }
      ]
   },
   "created_date":"2014-12-05T21:00:13.150913+00:00"
}