openapi: 3.0.1
info:
  title: DATA EXPORT API
  termsOfService: https://egym.com/en/terms/
  contact:
    name: MMS Connect Team
    url: https://egym.com/
    email: connect@egym.com
  version: Alpha preview
servers:
- url: https://one-mms-service.ext-1.test.co.egym.coffee
  description: Test
- url: https://mms.api.egym.com
  description: Prod
security:
- mms: []
tags:
- name: Measurements
  description: These operations are needed to retrieve measurements with corresponding metrics. Additional permissions are
    required to access these endpoints.
- name: Workouts
  description: These operations are needed to retrieve workouts. Additional permissions are required to access these endpoints.
paths:
  /api/v2/accounts/{accountId}/workouts:
    get:
      tags:
      - Workouts
      summary: Workouts
      description: Retrieve workouts using accountId.
      operationId: getWorkouts
      parameters:
      - name: accountId
        in: path
        required: true
        schema:
          type: string
      - name: fromTimestamp
        in: query
        required: false
        schema:
          type: string
          format: date-time
      - name: toTimestamp
        in: query
        required: false
        schema:
          type: string
          format: date-time
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/WorkoutDetailsDTO'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
  /api/v2/accounts/{accountId}/measurements/strength:
    get:
      tags:
      - Measurements
      summary: Strength measurements
      description: Retrieve strength measurements using accountId.
      operationId: getStrengthMeasurements
      parameters:
      - name: accountId
        in: path
        required: true
        schema:
          type: string
      - name: fromTimestamp
        in: query
        required: true
        schema:
          type: string
          format: date-time
      - name: toTimestamp
        in: query
        required: true
        schema:
          type: string
          format: date-time
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/StrengthMeasurementDTO'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
  /api/v2/accounts/{accountId}/measurements/cardio:
    get:
      tags:
      - Measurements
      summary: Cardio measurements
      description: Retrieve cardio measurements using accountId.
      operationId: getCardioMeasurements
      parameters:
      - name: accountId
        in: path
        required: true
        schema:
          type: string
      - name: fromTimestamp
        in: query
        required: true
        schema:
          type: string
          format: date-time
      - name: toTimestamp
        in: query
        required: true
        schema:
          type: string
          format: date-time
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MeasurementDTO'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
  /api/v2/accounts/{accountId}/measurements/body:
    get:
      tags:
      - Measurements
      summary: Body measurements
      description: Retrieve body measurements using accountId.
      operationId: getBodyMeasurement
      parameters:
      - name: accountId
        in: path
        required: true
        schema:
          type: string
      - name: fromTimestamp
        in: query
        required: true
        schema:
          type: string
          format: date-time
      - name: toTimestamp
        in: query
        required: true
        schema:
          type: string
          format: date-time
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BodyMeasurementDTO'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDTO'
components:
  schemas:
    ErrorDTO:
      type: object
      properties:
        timestamp:
          type: string
          description: The timestamp of the request.
          format: date-time
        path:
          type: string
          description: The path requested.
        requestId:
          type: string
          description: The request ID.
          example: de625cf1-1
        status:
          type: integer
          description: The http status code.
          format: int32
        error:
          type: string
          description: The error.
        errorCode:
          type: string
          description: The static error code.
        message:
          type: string
          description: The message to describe the error.
        fieldErrors:
          type: array
          description: The constraint violations.
          items:
            $ref: '#/components/schemas/FieldErrorDTO'
        metadata:
          type: object
          additionalProperties:
            type: string
            description: Additional information of the error context
          description: Additional information of the error context
    FieldErrorDTO:
      type: object
      properties:
        name:
          type: string
          description: The field name.
          example: age
        message:
          type: string
          description: The error message.
          example: Must be greater than 10.
        rejectedValue:
          type: object
          description: The rejected value.
          example: 3
      description: The constraint violations.
    CombinedActivityDto:
      type: object
      properties:
        name:
          type: string
        rangeOfMotion:
          type: number
          format: double
        strengthBenchmarkMale:
          type: number
          format: double
        strengthBenchmarkFemale:
          type: number
          format: double
        calculationMethod:
          type: string
          enum:
          - ADD_SPECIFIED_WEIGHT
          - SUBTRACT_SPECIFIED_WEIGHT
        maxStrengthTestBodyRegion:
          type: string
          enum:
          - UPPER_BODY
          - CORE
          - LEGS
          - WHOLE
      description: Activity details
    HRMDataDto:
      type: object
      properties:
        targetHeartRate:
          type: integer
          format: int32
        zones:
          type: array
          items:
            $ref: '#/components/schemas/HeartRateZoneDto'
      description: HRM (heart rate monitor) data.
    HeartRateZoneDto:
      type: object
      properties:
        min:
          type: integer
          format: int32
        max:
          type: integer
          format: int32
        duration:
          type: integer
          format: int64
        label:
          type: string
        orderNumber:
          type: integer
          format: int32
    WorkoutDetailsDTO:
      type: object
      properties:
        exercises:
          type: array
          description: Exercises of workout
          items:
            $ref: '#/components/schemas/WorkoutExerciseDetailsDTO'
        completedAt:
          type: string
          description: Workout tracking local time
          format: date-time
        timezone:
          type: string
          description: Workout tracking timezone
          format: time-zone
    WorkoutExerciseDetailsDTO:
      type: object
      properties:
        id:
          type: integer
          description: Exercise ID
          format: int64
        activity:
          $ref: '#/components/schemas/CombinedActivityDto'
        sets:
          type: array
          description: Exercise sets
          items:
            $ref: '#/components/schemas/WorkoutExerciseSetDTO'
        completedAt:
          type: string
          description: Exercise completion local time
          format: date-time
        timezone:
          type: string
          description: Exercise completion timezone
          format: time-zone
        kiloCalories:
          type: number
          description: Exercise kilocalories
          format: double
        hrmData:
          $ref: '#/components/schemas/HRMDataDto'
        summary:
          $ref: '#/components/schemas/WorkoutExerciseSummaryDTO'
      description: Exercises of workout
    WorkoutExerciseSetDTO:
      required:
      - setType
      type: object
      properties:
        setType:
          type: string
          description: The type of the training set, i.e. REP_BASED or TIME_BASED.
          enum:
          - REP_BASED
          - TIME_BASED
        numberOfReps:
          type: integer
          description: Set number of repetitions
          format: int32
        weight:
          type: number
          description: Set weight in kilograms/pounds
          format: double
        duration:
          type: integer
          description: Set duration in seconds
          format: int64
        distance:
          type: number
          description: Set distance in meters
          format: double
        heartRate:
          type: integer
          description: Set heart rate in beats per minute (bpm)
          format: int32
        speed:
          type: number
          description: Set speed in metres per second
          format: double
        incline:
          type: number
          description: Set incline
          format: double
        recoveryTime:
          type: integer
          description: Set recovery time in seconds
          format: int64
      description: Exercise sets
    WorkoutExerciseSummaryDTO:
      type: object
      properties:
        totalDuration:
          type: integer
          description: Total duration of the whole exercise in seconds.
          format: int64
        totalDistance:
          type: number
          description: The total distance of the whole exercise in metres.
          format: double
        verticalDistance:
          type: number
          description: The vertical distance of this exercise in metres.
          format: double
        avgPace:
          type: number
          description: Average pace in minute per kilometer
          format: double
        avgHeartRate:
          type: integer
          description: Average heart rate in beats per minute (bpm)
          format: int32
        maxHeartRate:
          type: integer
          description: Max heart rate in beats per minute (bpm)
          format: int32
        avgSpeed:
          type: number
          description: Average speed in in metres per second
          format: double
        avgIncline:
          type: number
          description: Average incline
          format: double
      description: Workout summary contains data fields which summarize the exercise, thus one does not need to go over all
        sets.
    DatedValueWithProgressDTO:
      type: object
      properties:
        value:
          type: number
          description: Value of measurement
          format: double
        createdAt:
          type: string
          description: DateTime when measurement was conducted
          format: date-time
    StrengthMeasurementDTO:
      type: object
      properties:
        createdAt:
          type: string
          format: date-time
        strength:
          $ref: '#/components/schemas/DatedValueWithProgressDTO'
        source:
          type: string
        bodyRegion:
          type: string
          enum:
          - ALL
          - UPPER
          - CORE
          - LOWER
          - UNSPECIFIED
        machineType:
          type: string
    MeasurementDTO:
      type: object
      properties:
        createdAt:
          type: string
          description: Time at which measurement was created
          format: date-time
        source:
          type: string
          description: Source of the measurement
          example: MANUAL
        metrics:
          type: array
          description: Metrics associated with this measurement
          items:
            $ref: '#/components/schemas/MetricDTO'
        equipmentType:
          type: string
    MetricDTO:
      type: object
      properties:
        type:
          type: string
          description: Type of metric
          example: BODY_FAT_PERCENTS
        value:
          type: number
          description: Value of metric
          format: double
        unit:
          type: string
          description: Unit of metric
          example: PERCENTS
          enum:
          - PERCENTS
          - CM
          - KG
          - KJ
          - LITER
          - CM2
          - OTHER
      description: Metrics associated with this measurement
    BodyMeasurementDTO:
      type: object
      properties:
        createdAt:
          type: string
          description: Time at which measurement was created
          format: date-time
        source:
          type: string
          description: Source of the measurement
          example: MANUAL
        metrics:
          type: array
          description: Metrics associated with this measurement
          items:
            $ref: '#/components/schemas/MetricWithInterpretationDTO'
        equipmentType:
          type: string
    Interpretation:
      type: object
      properties:
        label:
          type: string
          enum:
          - UNSPECIFIED
          - NORMAL
          - EXCELLENT
          - ELEVATED
          - LOW
        region:
          $ref: '#/components/schemas/InterpretationRegion'
      description: Interpretation of metric
    InterpretationRegion:
      type: object
      properties:
        low:
          type: number
          format: double
        top:
          type: number
          format: double
        labels:
          $ref: '#/components/schemas/Labels'
    Labels:
      type: object
      properties:
        low:
          type: string
          enum:
          - UNSPECIFIED
          - NORMAL
          - EXCELLENT
          - ELEVATED
          - LOW
        middle:
          type: string
          enum:
          - UNSPECIFIED
          - NORMAL
          - EXCELLENT
          - ELEVATED
          - LOW
        top:
          type: string
          enum:
          - UNSPECIFIED
          - NORMAL
          - EXCELLENT
          - ELEVATED
          - LOW
    MetricWithInterpretationDTO:
      type: object
      properties:
        type:
          type: string
          description: Type of metric
          example: BODY_FAT_PERCENTS
        value:
          type: number
          description: Value of metric
          format: double
        interpretation:
          $ref: '#/components/schemas/Interpretation'
        unit:
          type: string
          description: Unit of metric
          example: PERCENTS
          enum:
          - PERCENTS
          - CM
          - KG
          - KJ
          - LITER
          - CM2
          - OTHER
      description: Metrics associated with this measurement
  securitySchemes:
    mms:
      type: apiKey
      description: Authentication is validated via an API key that is generated by EGYM for each gym location. This API key
        will not be identical with the access token used in the EGYM Gym API v1
      name: x-api-key
      in: header
x-stoplight:
  id: api