Introduction
PerfectGym system is growing very fast. We are developing new features on a daily basis, adapting to new markets and covering more and more business models. To reduce maintenance costs and provide Clubs with a more stable PGM system version with a significant number of usable endpoints, we've decided to turn off the API v1.
We have introduced API v2 in 2021, which offers improved speed and flexibility. A majority of our clients have already migrated to it, and we highly encourage you to join them. Read more.
API v1 is being phased out. This means we are no longer developing it and you cannot build new integrations based on API v1. You have until October 1, 2023 to migrate
What it means for developers supporting my club?
We recommend to review your integration and make sure that you don't make any calls to API v1. If this is the case, development work on your side may be required.
What I need to do before 1st of October?
Verify your API usage in case of endpoints from API v1. All endpoints, which doesn't have in the title '/v2/' are using API v1 and should be migrated to the APIv2 endpoints.
What will happen after 1st of October?
API v1 will be decommissioned and you won't be able to use it.
If I don't make any changes what will happen?
Your integration and custom apps build based on PG API v1 may stop working properly. It could include a group class timetable on your website, an online joining form, custom mobile app or synchronization with external systems. If you use Perfect Gym Client Portal or Perfect Gym Go app, those solutions are unaffected.
Before you start
Please verify your API usage in case of endpoints from API v1. All endpoints, which doesn't have in the title '/v2.1/' are using API v1 and should be migrated to the APIv2 endpoints.
Example
API v1 endpoint looks like - Classes/UserClasses
API v2 endpoint looks like - /v2.1/odata/Classes
List of API v1 endpoints reflected in the API v2
Below, you will find the reflection of the endpoints with links to the detailed documentation.
Hints
Not every endpoint in API v2 works exactly as the respective endpoint in API v1. Contact Perfect Gym Support Team if you have trouble performing some operations using API v2 that you could do in the API v1.