# Myzone Documentation > Documentation for Myzone ## APIs: GETTING STARTED - [Your first API call](https://docs.myzone.org/reference/your-first-api-call.md): Learn how to make your first API call. - [OAuth 2.0](https://docs.myzone.org/reference/oauth-20-grant-types.md) - [Rate Limits](https://docs.myzone.org/reference/rate-limits.md): To ensure fair use and consistent performance, our API enforces rate limits at both **minute-level** and **monthly** intervals. - [Webhooks](https://docs.myzone.org/reference/webhooks-1.md): How to register a webhook ## APIs: Endpoints - Accounts - [Get details of a specific user account](https://docs.myzone.org/reference/getv1accountsaccountid.md): Retrieves detailed information about a user account identified by `accountId`. The response includes personal details, contact information, and other relevant account data. - [Update an existing user account](https://docs.myzone.org/reference/putv1accountsaccountid.md): Modifies the details of an existing user account identified by `accountId`. The request allows updating user information such as firstname, surname and email. **Note:** - Partial updates are… - [Retrieve a list of user accounts](https://docs.myzone.org/reference/getv1accounts.md): Retrieves a **paginated list** of user accounts. Optional filters can be applied to refine the results, such as `externalId` which can be used to filter accounts based on your own identifier. - [Register a new user account](https://docs.myzone.org/reference/postv1accounts.md): Creates a new user account and assigns a unique `accountId`. Upon success, the API returns a unique `accountId` for the newly created account. **Note:** - Users must be at least 16 years old to… - [Get stats associated with an account](https://docs.myzone.org/reference/get_v1-accounts-accountid-stats.md): Retrieves all stats linked to the account identified by `accountId`. Stats include current **rank** (i.e Copper, Iron ... HOF etc), **total MEPs** and **aggregated data on meps, calories and number… - [Get devices associated with an account](https://docs.myzone.org/reference/get_v1-accounts-accountid-devices.md): Retrieves all devices linked to the account identified by `accountId`. This includes wearable devices and integrations (e.g., MYZONE, APPLE, ANDROID). - [Add a myzone device to an account](https://docs.myzone.org/reference/post_v1-accounts-accountid-devices.md): Adds a myzone device to an account, only one myzone device per account is allowed. If the account already has a myzone device assigned it will be replaced. An additional loan device can also be added. - [Remove a myzone device from an account](https://docs.myzone.org/reference/delete_v1-accounts-accountid-devices-deviceid.md): Removes a myzone device from an account - [Remove accounts from a facility](https://docs.myzone.org/reference/patch_v1-facilities-facilityid-removeaccounts.md): Removes the provided lists of accounts from a facility and moves them to their countries default facility - Moves - [Retrieve a user's move history](https://docs.myzone.org/reference/getv1movesaccountid.md): 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… - [Retrieve a user's move](https://docs.myzone.org/reference/get_v1-moves-accountid-moveid.md): Fetches a requested user's move. - Biometrics - [Retrieve a user's biometric data](https://docs.myzone.org/reference/get_v1-accounts-accountid-biometrics.md): Fetches a user's biometric data, including various body composition metrics. **Note:** - All values are returned in metric units. - [Update a user's biometric data](https://docs.myzone.org/reference/put_v1-accounts-accountid-biometrics.md): Updates the biometric details of a specified user account. **Note:** - All input values must be provided in metric units. - Partial updates are supported, meaning only the fields provided in the… - [Retrieve biometric data for multiple users](https://docs.myzone.org/reference/get_v1-biometrics.md): Returns a **paginated list** of biometric data for all users in the system. **Note:** - All values are returned in metric units. - Classes And Booking - [Retrieve a list of class templates](https://docs.myzone.org/reference/getv1classtemplates.md): Returns a **paginated list** of class templates available in the system. Class templates are **predefined workout programs** created using the class creator. These templates can be optionally… - [Retrieve a list of classes](https://docs.myzone.org/reference/getv1classes.md): Returns a **paginated list** of all scheduled classes. Classes represent scheduled sessions within a facility. Optional filters can be applied to refine the results. - [Retrieve a list of shared classes](https://docs.myzone.org/reference/get_v1-classes-shared.md): Returns a **paginated list** of all scheduled mz-together classes available to the facility. Classes represent scheduled sessions within a facility. Optional filters can be applied to refine the… - [Create a new class](https://docs.myzone.org/reference/postv1classes.md): Creates a new scheduled class within a facility. The request body allows defining attributes such as the class name, facility, schedule, and an optional workout program `classTemplateId`. **Note:**… - [Delete a specific class](https://docs.myzone.org/reference/patch_v1-classes-classid-delete.md): Deletes a scheduled class identified by `classId`. If a class is deleted any class occurences will no longer be available. - [Retrieve details of a specific class](https://docs.myzone.org/reference/getv1classesclassid.md): Fetches details about a scheduled class identified by `classId`. This endpoint provides information such as the class schedule, associated facility. - [Update a specific class](https://docs.myzone.org/reference/putv1classesclassid.md): Updates details of an existing class identified by `classId`. The request body allows modifying attributes such as the class name, facility, schedule, and optionally associating a workout… - [Retrieve occurrences of a class](https://docs.myzone.org/reference/getv1classesclassidoccurrences.md): Returns a paginated list of **scheduled occurrences** for a given class referenced by `classId`. Occurrences represent specific instances of a class on a particular date and time. - [Retrieves details of a specific class occurrence](https://docs.myzone.org/reference/getv1classesoccurrencesoccurrenceid.md): Fetches details of a specific **class occurrence**, identified by `occurrenceId`. - [Update a class occurrence](https://docs.myzone.org/reference/putv1classesoccurrencesoccurrenceid.md): Updates details of a specific **class occurrence**, such as its schedule. **Note:** - Only provided fields in the request body will be updated. - [Retrieve bookings for a class occurrence](https://docs.myzone.org/reference/getv1classesoccurrencesoccurrenceidbookings.md): Returns a paginated list of users booked into a specific occurrence of a class. Filters allow paginating results for classes with lots of bookings. - [Books a user into a class occurrence.](https://docs.myzone.org/reference/postv1classesoccurrencesoccurrenceidbookings.md): Adds a user's account to the booking list for a specific occurrence of a class. - [Delete a booking (soft delete only)](https://docs.myzone.org/reference/delete_v1-classes-occurrences-bookings-bookingid.md): Removes a user from a booked class occurrence using `bookingId` - [Cancel a booking (soft delete, credit refund and waiting list promtion)](https://docs.myzone.org/reference/patch_v1-classes-occurrences-bookings-bookingid-delete.md): Removes a user from a booked class occurrence using `bookingId`. Promotes an acoount in the class waiting list. And refunds any credits. - Challenges - [Retrieve a list of challenges](https://docs.myzone.org/reference/get_v1-challenges.md): Returns a **paginated list** of challenges avaliable within the system. Challenges are structured competitions that may have MEP goals, tume-based constraints and specific zone filters. - [Retrieve the leaderboard for a challenge](https://docs.myzone.org/reference/get_v1-challenges-challengeid-leaderboard.md): Returns a **paginated list** of users participating in a challenge, ordered by score. This endpoint provides rankings based on challenge performance, with the highest-scoring user appearing first. - Groups - [Retrieve a list of groups](https://docs.myzone.org/reference/get_v1-groups-accounts.md): Returns a **paginated list** of groups associated with the accounts. - [Retrieve a list of groups](https://docs.myzone.org/reference/get_v1-facilities-facilityid-groups.md): Returns a **paginated list** of groups availble to the facility - [Create a group](https://docs.myzone.org/reference/post_v1-groups.md): Creates a group in the facility. - [Delete a group](https://docs.myzone.org/reference/delete_v1-facilities-facilityid-groups-groupid.md): Deletes a group from the facility - [Add/Remove accounts from a group](https://docs.myzone.org/reference/patch_v1-facilities-facilityid-groups-groupid-users.md): Adds/Removes the provided lists of accounts to a group - Facilities - [Retrieve a list of facilities](https://docs.myzone.org/reference/get_v1-facilities.md): Returns a **paginated list** of facilities accessible within your scope. - Reports - [Get a report for a specified facility](https://docs.myzone.org/reference/get_v1-facilities-facilityid-reports-report.md): Retrieves report data for the facility specified. Reports include: - `facility_leaderboard` : A leaderboard of your facility members for the current month. - `facility_mep_target_status`: A break… - [Get a report for a specified move](https://docs.myzone.org/reference/get_v1-moves-moveid-reports-report.md): Retrieves report data for the move specified. Reports include: - `heart_rate` : Heart rate data for the move. - Webhooks - [Register a webhook](https://docs.myzone.org/reference/post_v1-webhooks.md): Register a webhook subscription. Requires the `write:webhooks` scope and the event's data scope (`read:moves` for `workout.completed`). **Idempotent**: registering the same `event` + `url` again… - [List your webhooks](https://docs.myzone.org/reference/get_v1-webhooks.md): Returns only the webhook subscriptions owned by the calling client. Requires the `read:webhooks` scope. - [Delete a webhook](https://docs.myzone.org/reference/delete_v1-webhooks-id.md): Delete a webhook subscription the calling client owns. Requires the `delete:webhooks` scope. Deleting an `id` that doesn't exist or that your client doesn't own returns `404`. ## Recipes - [Authorization Code Flow with PKCE](https://docs.myzone.org/recipes/authorization-code-flow-with-pkce.md) - [Handling API Rate Limiting in JavaScript](https://docs.myzone.org/recipes/handling-api-rate-limiting-in-javascript.md) - [OAuth 2.0 Client Credentials Authentication](https://docs.myzone.org/recipes/oauth-20-authentication-with-javascript.md) - [OIDC Authorization Code Flow with PKCE](https://docs.myzone.org/recipes/oidc-authorization-code-flow-with-pkce.md) ## Changelog - [Moves timezone patch](https://docs.myzone.org/changelog/moves-timezone-patch.md) - [August Upate](https://docs.myzone.org/changelog/august-upate.md) - [July Update](https://docs.myzone.org/changelog/july-update.md) - [June Update](https://docs.myzone.org/changelog/june-update.md) - [May Update](https://docs.myzone.org/changelog/may-update.md) - [March Update](https://docs.myzone.org/changelog/march-update.md) - [February Update](https://docs.myzone.org/changelog/february-update.md) - [User group end points](https://docs.myzone.org/changelog/user-group-end-points.md) - [Moves report](https://docs.myzone.org/changelog/moves-report.md) - [Timezones](https://docs.myzone.org/changelog/timezones.md)