Myzone Moves API

The Moves API from Myzone — 2 operation(s) for moves.

GitHub OpenAPI

Operations 2

GET /v1/moves/{accountId} Retrieve a user's move history #
GET /v1/moves/{accountId}/{moveId} Retrieve a user's move #

Specifications

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/myzone:myzone-moves-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

myzone-moves-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: external-api Moves API
  description: The Myzone external API
  version: 1.0.0
servers:
- url: https://ext-api.myzone.org
  description: Live API
tags:
- name: Moves
paths:
  /v1/moves/{accountId}:
    get:
      tags:
      - Moves
      summary: Retrieve a user's move history
      description: 'Fetches a **paginated list** of a user''s recorded moves, ordered by start date and time in **descending** order (most recent first).


        The `start` parameter is required to define the initial range of moves.


        `read:moves:hr` scope is required to retrieve heartrate data'
      parameters:
      - name: accountId
        in: path
        description: The requested account's ID
        required: true
        schema:
          type: string
      - name: start
        in: query
        description: The start date and time of when you want workouts from. RFC3339 without milliseconds.
        required: false
        schema:
          type: string
        example: YYYY-MM-DDTHH:mm:ssZ
      - name: end
        in: query
        description: The end date and time of when you want workouts until. RFC3339 without milliseconds.
        required: false
        schema:
          type: string
        example: YYYY-MM-DDTHH:mm:ssZ
      - name: limit
        in: query
        description: The number of records to fetch.
        required: false
        schema:
          maximum: 100
          minimum: 1
          type: integer
          default: 10
      - name: offset
        in: query
        description: The number of records skipped.
        required: false
        schema:
          minimum: 0
          type: integer
          default: 0
      responses:
        '200':
          description: Successfully retrieved the user's move history.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedMoves'
              examples:
                move found:
                  value: "{\n  \"offset\": 0,\n  \"limit\": 10,\n  \"total\": 1,\n  \"items\": [\n      {\n          \"moveId\": \"string\",\n          \"deviceId\": 0,\n          \"title\": \"Workout\",\n          \"type\": \"string\",\n          \"start\": \"2025-12-19T11:42:20+00:00\",\n          \"end\": \"2025-12-19T12:29:20+00:00\",\n          \"meps\": 0,\n          \"duration\": 47,\n          \"calories\": 0,\n          \"zone0\": {\n              \"mins\": 47,\n              \"MEPs\": 0\n          },\n          \"zone1\": {\n              \"mins\": 0,\n              \"MEPs\": 0\n          },\n          \"zone2\": {\n              \"mins\": 0,\n              \"MEPs\": 0\n          },\n          \"zone3\": {\n              \"mins\": 0,\n              \"MEPs\": 0\n          },\n          \"zone4\": {\n              \"mins\": 0,\n              \"MEPs\": 0\n          },\n          \"zone5\": {\n              \"mins\": 0,\n              \"MEPs\": 0\n          },\n          \"avgEffort\": 34,\n          \"avgHr\": 66,\n          \"peakHr\": 89,\n          \"graphURL\": \"string\"\n      }\n  ]\n}"
        '400':
          $ref: '#/components/responses/400Error'
        '401':
          $ref: '#/components/responses/401Error'
        '403':
          $ref: '#/components/responses/403Error'
        '404':
          $ref: '#/components/responses/404Error'
      security:
      - OAuth2:
        - read:moves
      operationId: getV1MovesByAccountId
      x-operation-id-source: derived
  /v1/moves/{accountId}/{moveId}:
    get:
      tags:
      - Moves
      summary: Retrieve a user's move
      description: Fetches a requested user's move.
      parameters:
      - name: accountId
        in: path
        description: The requested account's ID
        required: true
        schema:
          type: string
      - name: moveId
        in: path
        description: The requested moves's ID
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successfully retrieved the user's move history.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MoveFields'
              examples:
                move found:
                  value: "{\n    \"moveId\": \"string\",\n    \"deviceId\": 0,\n    \"title\": \"Workout\",\n    \"type\": \"string\",\n    \"start\": \"2025-12-19T11:42:20+00:00\",\n    \"end\": \"2025-12-19T12:29:20+00:00\",\n    \"meps\": 0,\n    \"duration\": 47,\n    \"calories\": 0,\n    \"zone0\": {\n        \"mins\": 47,\n        \"MEPs\": 0\n    },\n    \"zone1\": {\n        \"mins\": 0,\n        \"MEPs\": 0\n    },\n    \"zone2\": {\n        \"mins\": 0,\n        \"MEPs\": 0\n    },\n    \"zone3\": {\n        \"mins\": 0,\n        \"MEPs\": 0\n    },\n    \"zone4\": {\n        \"mins\": 0,\n        \"MEPs\": 0\n    },\n    \"zone5\": {\n        \"mins\": 0,\n        \"MEPs\": 0\n    },\n    \"avgEffort\": 34,\n    \"avgHr\": 66,\n    \"peakHr\": 89,\n    \"graphURL\": \"string\"\n}"
        '400':
          $ref: '#/components/responses/400Error'
        '401':
          $ref: '#/components/responses/401Error'
        '403':
          $ref: '#/components/responses/403Error'
        '404':
          $ref: '#/components/responses/404Error'
      security:
      - OAuth2:
        - read:moves
      x-internal: false
      operationId: getV1MovesByAccountIdByMoveId
      x-operation-id-source: derived
components:
  responses:
    401Error:
      description: Unauthorized request
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
    403Error:
      description: Forbidden request
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
    404Error:
      description: Endpoint not found
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
    400Error:
      description: Invalid request
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
  schemas:
    ZoneObject:
      type: object
      properties:
        mins:
          type: integer
          description: The ammount of minutes spent within this zone.
        MEPs:
          type: integer
          description: The ammount of MEPs earnt in this zone.
    MoveFields:
      type: object
      properties:
        deviceId:
          type: integer
          description: The device identifier, previously known as belt number.
        meps:
          type: integer
          description: The total Myzone Effort Points (MEPs) for the move.
        duration:
          type: integer
          description: The length of the move in minutes
        zone0:
          $ref: '#/components/schemas/ZoneObject'
        zone1:
          $ref: '#/components/schemas/ZoneObject'
        zone2:
          $ref: '#/components/schemas/ZoneObject'
        zone3:
          $ref: '#/components/schemas/ZoneObject'
        zone4:
          $ref: '#/components/schemas/ZoneObject'
        zone5:
          $ref: '#/components/schemas/ZoneObject'
        avgEffort:
          type: integer
          description: The average percentage of max heart rate for the move.
        avgHR:
          type: integer
          description: The average heart rate for the move.
        calories:
          type: integer
          description: Calories burnt in move.
        peakHR:
          type: integer
          description: The maximum heart rate reached in move.
        moveId:
          type: string
          description: The identifier for the move.
          format: UUID
        title:
          type: string
          description: The title of the move
        type:
          type: string
          description: The type of move
        start:
          type: string
          description: The start date and time of the move. In the accounts timezone.
          example: '2020-01-01T12:00:00+00:00'
        end:
          type: string
          description: The end date and time of the move.  In the accounts timezone.
          example: '2020-01-01T12:00:00+00:00'
        graphURL:
          type: string
          description: The url to the graph image.
    PagedMoves:
      type: object
      properties:
        limit:
          maximum: 100
          minimum: 1
          type: integer
          example: 1
        offset:
          minimum: 0
          type: integer
        total:
          type: integer
          example: 1
        items:
          type: array
          items:
            $ref: '#/components/schemas/MoveFields'
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://auth.myzone.org/access_token
          scopes:
            read:accounts: client has read access to account api
            write:accounts: client has write access to accounts api
            read:moves: client has read access to moves api
            read:biometrics: client has read access to biometrics api
            write:biometrics: client has write access to biometrics api
            read:classes_and_bookings: client has read access to classes and bookings api
            write:classes_and_bookings: client has write access to classes and bookings api
            delete:classes_and_bookings: client has delete access to classes and bookings api
            read:challenges: client has read access to challenges api
            read:facilities: client has read access to facilities api
            read:reports: client has read access to reports api
            read:groups: client has read access to groups api
            write:groups: client has write access to groups api
            delete:groups: client has delete access to groups api
            read:moves:hr: client has read access to heart rate data
        authorizationCode:
          authorizationUrl: https://auth.myzone.org/authorize
          tokenUrl: https://auth.myzone.org/access_token
          scopes:
            read:accounts: client has read access to account api
            write:accounts: client has write access to accounts api
            read:moves: client has read access to moves api
            read:biometrics: client has read access to biometrics api
            write:biometrics: client has write access to biometrics api
            read:classes_and_bookings: client has read access to classes and bookings api
            write:classes_and_bookings: client has write access to classes and bookings api
            delete:classes_and_bookings: client has delete access to classes and bookings api
            read:challenges: client has read access to challenges api
            read:facilities: client has read access to facilities api
            read:reports: client has read access to reports api
            read:groups: client has read access to groups api
            write:groups: client has write access to groups api
            delete:groups: client has delete access to groups api
x-provenance:
  method: searched
  source: https://docs.myzone.org/reference
  harvested: '2026-11-16'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.myzone.org/reference/delete_v1-accounts-accountid-devices-deviceid.md
  - https://docs.myzone.org/reference/delete_v1-classes-occurrences-bookings-bookingid.md
  - https://docs.myzone.org/reference/delete_v1-facilities-facilityid-groups-groupid.md
  - https://docs.myzone.org/reference/delete_v1-webhooks-id.md
  - https://docs.myzone.org/reference/get_v1-accounts-accountid-biometrics.md
  - https://docs.myzone.org/reference/get_v1-accounts-accountid-devices.md
  - https://docs.myzone.org/reference/get_v1-accounts-accountid-stats.md
  - https://docs.myzone.org/reference/get_v1-biometrics.md
  - https://docs.myzone.org/reference/get_v1-challenges-challengeid-leaderboard.md
  - https://docs.myzone.org/reference/get_v1-challenges.md
  - https://docs.myzone.org/reference/get_v1-classes-shared.md
  - https://docs.myzone.org/reference/get_v1-facilities-facilityid-groups.md
  - https://docs.myzone.org/reference/get_v1-facilities-facilityid-reports-report.md
  - https://docs.myzone.org/reference/get_v1-facilities.md
  - https://docs.myzone.org/reference/get_v1-groups-accounts.md
  - https://docs.myzone.org/reference/get_v1-moves-accountid-moveid.md
  - https://docs.myzone.org/reference/get_v1-moves-moveid-reports-report.md
  - https://docs.myzone.org/reference/get_v1-webhooks.md
  - https://docs.myzone.org/reference/getv1accounts.md
  - https://docs.myzone.org/reference/getv1accountsaccountid.md
  - https://docs.myzone.org/reference/getv1classes.md
  - https://docs.myzone.org/reference/getv1classesclassid.md
  - https://docs.myzone.org/reference/getv1classesclassidoccurrences.md
  - https://docs.myzone.org/reference/getv1classesoccurrencesoccurrenceid.md
  - https://docs.myzone.org/reference/getv1classesoccurrencesoccurrenceidbookings.md
  - https://docs.myzone.org/reference/getv1classtemplates.md
  - https://docs.myzone.org/reference/getv1movesaccountid.md
  - https://docs.myzone.org/reference/patch_v1-classes-classid-delete.md
  - https://docs.myzone.org/reference/patch_v1-classes-occurrences-bookings-bookingid-delete.md
  - https://docs.myzone.org/reference/patch_v1-facilities-facilityid-groups-groupid-users.md
  - https://docs.myzone.org/reference/patch_v1-facilities-facilityid-removeaccounts.md
  - https://docs.myzone.org/reference/post_v1-accounts-accountid-devices.md
  - https://docs.myzone.org/reference/post_v1-groups.md
  - https://docs.myzone.org/reference/post_v1-webhooks.md
  - https://docs.myzone.org/reference/postv1accounts.md
  - https://docs.myzone.org/reference/postv1classes.md
  - https://docs.myzone.org/reference/postv1classesoccurrencesoccurrenceidbookings.md
  - https://docs.myzone.org/reference/put_v1-accounts-accountid-biometrics.md
  - https://docs.myzone.org/reference/putv1accountsaccountid.md
  - https://docs.myzone.org/reference/putv1classesclassid.md
  - https://docs.myzone.org/reference/putv1classesoccurrencesoccurrenceid.md
  merge:
    pages: 41
    deduped: 224
    conflicts_kept_first: 0