Skip to content
PerfectGym Next Open API
/
/Customers Account

PerfectGym Next API (1.28.0)

  • Appointment, bookable appointment and slots operations
  • Redeem checkin vouchers
  • Class and slots operations
  • Cross studio operations
  • Get customers and contracts
  • Retrieve customer accounting details
  • Retrieve customer communication details
  • Retrieve customer transaction details
  • Get device information
  • Employee operations
  • Debt collection operations
  • Leads operations
  • Get member lists
  • Manage membership contracts
  • Membership operations
  • Online offer operations
  • Payment operations
  • Get studio information
  • Get trial offers information
Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Demo tenant

https://open-api-demo.open-api.perfectgym.com/

Mock server

https://redocly.sportalliance.com/_mock/apis/perfectgym/openapi/openapi/

Appointments

Appointment, bookable appointment and slots operations

Operations

Checkin vouchers

Redeem checkin vouchers

Operations

Classes

Class and slots operations

Operations

Cross Studio

Cross studio operations

Operations

Customers

Get customers and contracts

Operations

Customers Account

Retrieve customer accounting details

Operations

Get customer's account balance data

Request

Required Scopes: CUSTOMER_ACCOUNT_READ

Returns customer's current account balance data

Security
ApiKeyAuth
Path
customerIdinteger(int64)required

Unique ID of the customer

curl -i -X GET \
  'https://open-api-demo.open-api.perfectgym.com/v1/customers/{customerId}/account/balances' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
accountBalanceobject(Money)

Represents a financial data

consumptionCreditobject(Money)

Represents a financial data

dunningLevelstring

The dunning level of the customer

Example: "Dunning Level 1"
dunningLevelSincestring(date)

The date since the customer has the current dunning level

Example: "2025-08-24"
inDebtCollectionbooleanrequired

Whether the customers open debt claims where transferred to a debt collection agency

inDebtCollectionSincestring(date)

The date the customer was most recently transferred to a debt collection agency

Example: "2025-08-24"
lastAccountBalanceUpdatedstring(date)

The date of the customer's most recent debt claim

Example: "2025-08-24"
Response
application/json
{
  "accountBalance": {
    "amount": 20,
    "currency": "EUR"
  },
  "consumptionCredit": {
    "amount": 20,
    "currency": "EUR"
  },
  "dunningLevel": "Dunning Level 1",
  "dunningLevelSince": "2025-08-24",
  "inDebtCollection": true,
  "inDebtCollectionSince": "2025-08-24",
  "lastAccountBalanceUpdated": "2025-08-24"
}

Get customer's account past transactions in slices

Request

Required Scopes: CUSTOMER_ACCOUNT_READ

Returns customer's account transaction data for the past excluding today

Security
ApiKeyAuth
Path
customerIdinteger(int64)required

Unique ID of the customer

Query
sliceSizeinteger(int32)[ 1 .. 50 ]

Desired size of data chunk

Default 10
offsetstring

Offset from last request

Default "0"
curl -i -X GET \
  'https://open-api-demo.open-api.perfectgym.com/v1/customers/{customerId}/account/transactions?sliceSize=10&offset=0' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
resultArray of objects(BookingEntry)required

List of booking entries

result[].​idinteger(int64)required

The internal id of the entry

result[].​dueDatestring(date)required

Date to booking is/was to be paid

result[].​descriptionstring

Description of the booking

result[].​amountobject(Money)

Represents a financial data

result[].​openAmountobject(Money)

Represents a financial data

result[].​installmentPlanbooleanrequired

Whether or not the booking was transferred into an installment plan

result[].​chargeTypestringrequired

Represents the classification of the charge

Enum ValueDescription
IDLE_PERIOD_CHARGE

Charge for a freeze period

CREDIT

Credit from a freeze period

STARTER_PACKAGE

Initial package or starter kit charge

FLAT_FEE

One-time or recurring flat fee for additional services or products

CHARGED_BACK_FEE

Fee for chargeback processing

DEBT_CLAIM_REDUCTION

Reduction of an existing debt claim

DAMAGE_COMPENSATION

Compensation for damages or losses

CANCELATION_FEE

Fee for canceling a service or contract

MODULE_FEE

One-time or recurring module fee for additional services or products

SALES_DIRECT_DEBIT

Sale transaction via direct debit payment

Example: "MEMBERSHIP_CHARGE"
result[].​paidPeriodFromstring(date)

Start date of the service period (if applicable)

Example: "2025-01-01"
result[].​paidPeriodTostring(date)

End date of the service period (if applicable)

Example: "2025-01-31"
hasNextbooleanrequired

True if there exists next data slice

Example: true
offsetstringrequired

Offset for next query

Example: "1234567890"
Response
application/json
{
  "result": [
    { … }
  ],
  "hasNext": true,
  "offset": "1234567890"
}

Get customer's account upcoming transactions in slices within the next year

Request

Required Scopes: CUSTOMER_ACCOUNT_READ

Returns customer's account upcoming transaction data including today

Security
ApiKeyAuth
Path
customerIdinteger(int64)required

Unique ID of the customer

Query
sliceSizeinteger(int32)[ 1 .. 50 ]

Desired size of data chunk

Default 10
offsetstring

Offset from last request

Default "0"
curl -i -X GET \
  'https://open-api-demo.open-api.perfectgym.com/v1/customers/{customerId}/account/transactions/upcoming?sliceSize=10&offset=0' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
resultArray of objects(BookingEntry)required

List of booking entries

result[].​idinteger(int64)required

The internal id of the entry

result[].​dueDatestring(date)required

Date to booking is/was to be paid

result[].​descriptionstring

Description of the booking

result[].​amountobject(Money)

Represents a financial data

result[].​openAmountobject(Money)

Represents a financial data

result[].​installmentPlanbooleanrequired

Whether or not the booking was transferred into an installment plan

result[].​chargeTypestringrequired

Represents the classification of the charge

Enum ValueDescription
IDLE_PERIOD_CHARGE

Charge for a freeze period

CREDIT

Credit from a freeze period

STARTER_PACKAGE

Initial package or starter kit charge

FLAT_FEE

One-time or recurring flat fee for additional services or products

CHARGED_BACK_FEE

Fee for chargeback processing

DEBT_CLAIM_REDUCTION

Reduction of an existing debt claim

DAMAGE_COMPENSATION

Compensation for damages or losses

CANCELATION_FEE

Fee for canceling a service or contract

MODULE_FEE

One-time or recurring module fee for additional services or products

SALES_DIRECT_DEBIT

Sale transaction via direct debit payment

Example: "MEMBERSHIP_CHARGE"
result[].​paidPeriodFromstring(date)

Start date of the service period (if applicable)

Example: "2025-01-01"
result[].​paidPeriodTostring(date)

End date of the service period (if applicable)

Example: "2025-01-31"
hasNextbooleanrequired

True if there exists next data slice

Example: true
offsetstringrequired

Offset for next query

Example: "1234567890"
Response
application/json
{
  "result": [
    { … }
  ],
  "hasNext": true,
  "offset": "1234567890"
}

Book a payment for a customer

Request

Required Scopes: PAYMENT_WRITE

Request to book a payment for a specific customer. This endpoint is used to process payments associated with a member's account.

Security
ApiKeyAuth
Path
customerIdinteger(int64)required

Unique ID of the customer

Bodyapplication/jsonrequired
paymentRequestTokenstringrequired

Payment Request Token obtained by initializing the Universal Payment Component with a User Payment Session created via the OpenAPI. The token must belong to the same customer for whom the OpenAPI user is posting the payment. If the customer does not match the customer scope of the User Payment Session, an error is returned.

amountobject(Money)required

Total monetary amount to be paid, including currency information.

amount.​amountnumberrequired

Amount of the finance data tuple

Example: 20
amount.​currencystring(ISO 4217)required

Currency of the finance data tuple

Example: "EUR"
debtClaimIdsArray of integers(int64)

List of debt claim IDs that will be settled as part of this payment. If omitted or empty, all debt claims of the account will be balanced, given that the authorized amount of the payment request matches the open amount in the account.

curl -i -X POST \
  'https://open-api-demo.open-api.perfectgym.com/v1/customers/{customerId}/account/payment' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "paymentRequestToken": "string",
    "amount": {
      "amount": 20,
      "currency": "EUR"
    },
    "debtClaimIds": [
      0
    ]
  }'

Responses

OK

Bodyapplication/json
object(BookCustomerPaymentResponse)

Response to book a payment for a specific customer.

Response
application/json
{}

Update payment instrument of a customer

Request

Required Scopes: PAYMENT_WRITE

Update a payment instrument for a specific customer.

Security
ApiKeyAuth
Path
customerIdinteger(int64)required

Unique ID of the customer

Bodyapplication/jsonrequired
paymentRequestTokenstringrequired

Payment Request Token obtained by initializing the Universal Payment Component with a User Payment Session created via the OpenAPI. The token must belong to the same customer for whom the OpenAPI user is posting the payment. If the customer does not match the customer scope of the User Payment Session, an error is returned.

curl -i -X POST \
  'https://open-api-demo.open-api.perfectgym.com/v1/customers/{customerId}/account/payment-instrument' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "paymentRequestToken": "string"
  }'

Responses

OK

Bodyapplication/json
object(UpdateCustomerPaymentInstrumentResponseDto)

Update customer payment instrument response.

Response
application/json
{}

Get payment details of a customer

Request

Required Scopes: PAYMENT_READ

Get payment details for a specific customer.

Security
ApiKeyAuth
Path
customerIdinteger(int64)required

Unique ID of the customer

curl -i -X GET \
  'https://open-api-demo.open-api.perfectgym.com/v1/customers/{customerId}/account/payment-details' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
defaultPaymentMethodstringrequired

Customer's default payment method

Enum ValueDescription
DIRECT_DEBIT

Direct debit payment method

TWINT

Twint payment method

UNDEFINED

Payment method is undefined

BANK_TRANSFER

Bank transfer payment method

CASH

Cash payment method

CREDIT_CARD

Credit card payment method

Example: "DIRECT_DEBIT"
paymentInstrumentsArray of objects(PaymentInstrument)

Payment instruments assigned to customer

Response
application/json
{
  "defaultPaymentMethod": "DIRECT_DEBIT",
  "paymentInstruments": [
    { … }
  ]
}

Get customer's current dunning

Request

Required Scopes: CUSTOMER_DUNNING_READ

Returns the customer's current dunning together with the debt claims it was raised for, and whether that dunning is currently refusing the customer entry to the studio. Answers whether a member is locked out because of unpaid debt, and which debt - neither the account balance nor the customer endpoint answers that on its own.

Security
ApiKeyAuth
Path
customerIdinteger(int64)required

Unique ID of the customer

curl -i -X GET \
  'https://open-api-demo.open-api.perfectgym.com/v1/customers/{customerId}/account/dunning' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
dunnedboolean

Whether the customer has current dunning information. When false, other fields are false, null or empty

Example: true
accessRestrictedboolean

Whether the current dunning information has a service stop

Example: true
dunningLevelstring

Name of the dunning level the customer reached

Example: "Dunning Level 2"
dunningDatestring(date)

Date of the current dunning information

Example: "2026-06-09"
amountobject(Money)

Total amount the dunning was raised for

feeobject(Money)

Fee charged for the dunning itself, if the studio charges one

inDebtCollectionboolean

Whether the claims were handed to a debt collection agency

Example: false
collectionStopboolean

Whether the dunning also stopped collection of further claims

Example: false
debtClaimsArray of objects(CustomerDunningClaim)

The debt claims this dunning was raised for, oldest due date first

Response
application/json
{
  "dunned": true,
  "accessRestricted": true,
  "dunningLevel": "Dunning Level 2",
  "dunningDate": "2026-06-09",
  "amount": {
    "amount": 20,
    "currency": "EUR"
  },
  "fee": {
    "amount": 20,
    "currency": "EUR"
  },
  "inDebtCollection": false,
  "collectionStop": false,
  "debtClaims": [
    { … }
  ]
}

Customers Communication

Retrieve customer communication details

Operations

Customers Self-service

Operations

Customers Transactions

Retrieve customer transaction details

Operations

Devices

Get device information

Operations

Employees

Employee operations

Operations

Finance

Debt collection operations

Operations

Leads

Leads operations

Operations

Member Lists

Get member lists

Operations

Membership Self-service

Manage membership contracts

Operations

Memberships

Membership operations

Operations

Online offers

Online offer operations

Operations

Payments

Payment operations

Operations

Studios

Get studio information

Operations

Trial Offers

Get trial offers information

Operations