---
title: "Check API usage and limits (includes monthly exercise cap)"
method: GET
path: "/usage"
tags: ["Account"]
---

# Check API usage and limits (includes monthly exercise cap)

`GET /usage`

## Request

- Base URL: `https://exercise-api.ymove.app/api/v2`
- URL: `https://exercise-api.ymove.app/api/v2/usage`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`

## Response `200`

Current usage data including monthly exercise cap

- object
  - `data` Usage
    - `plan` string
    - `status` string: Account status (e.g. "active", "trial")
    - `minutesUsed` integer
    - `minutesLimit` integer
    - `minutesRemaining` integer
    - `percentUsed` integer
    - `rateLimit` integer: Requests per minute allowed for your plan
    - `monthlyExercisesUsed` integer: Distinct exercises accessed in last 30 days
    - `monthlyExerciseLimit` union: Max unique exercises per month for your plan. Returns "unlimited" for yearly plans.
      - integer
      - 'unlimited'
    - `postureAnalyses` object
      - `used` integer
      - `included` integer
      - `remaining_free` integer
      - `overage_count` integer
      - `overage_charge` number
      - `price_per_extra` number
    - `whiteVideoAccess` boolean
    - `premiumVideoAccess` boolean
    - `trialEndsAt` string, date-time, nullable: ISO 8601 timestamp when trial expires (null for non-trial accounts)

---

[API](https://skmtc.dev/ymove/apis/ymove-fitness-api.md) · [All operations](https://skmtc.dev/ymove/apis/ymove-fitness-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ymove/apis/ymove-fitness-api/revisions/6636f2b4a343?raw)