Skip to content
PerfectGym Next Open API
/
/Member Lists

PerfectGym Next API (1.16.3)

  • 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

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

Get member lists

Request

Required Scopes: MEMBER_LIST_READ

Returns all member lists configured for the studio

Security
ApiKeyAuth
curl -i -X GET \
  https://open-api-demo.open-api.perfectgym.com/v1/member-lists \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/jsonArray [
listIdinteger(int64)required

Unique ID of the member list

Example: 1234567890
namestringrequired

Name of the member list

Example: "Active members"
modifiedDateTimestring(date-time)required

Last member list update date time

Example: "2022-06-15T23:59:59.999+02:00"
]
Response
application/json
[
  {
    "listId": 1234567890,
    "name": "Active members",
    "modifiedDateTime": "2022-06-15T23:59:59.999+02:00"
  }
]

Get member list customers

Request

Required Scopes: MEMBER_LIST_READ

Returns customers matching the member list in expected slices

Security
ApiKeyAuth
Path
listIdinteger(int64)required

Unique ID of the member list

Query
cardNumberFormatstring(CardNumberFormat)

Defines how card numbers are interpreted

Default "DECIMAL"
Enum"DECIMAL""HEX_MSB""HEX_LSB"
offsetstring

Offset from last request (last ID of the customer)

sliceSizeinteger(int32)[ 50 .. 500 ]

Desired size of data chunk

Default 100
curl -i -X GET \
  'https://open-api-demo.open-api.perfectgym.com/v1/member-lists/{listId}/customers?cardNumberFormat=DECIMAL&offset=string&sliceSize=100' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
resultArray of objects(Customer)required

List of customers

result[].​idinteger(int64)required

Unique ID of the customer

Example: 1001
result[].​customerNumberstring

Customer number

Example: "1-12345"
result[].​firstNamestring

First name of the customer

Example: "Edgar"
result[].​secondFirstNamestring

Second first name of the customer

Example: "Thomas"
result[].​lastNamestring

Surname of the customer

Example: "Bullock"
result[].​secondLastNamestring

Second last name of the customer

Example: "Meyer"
result[].​dateOfBirthstring(date)

Birthday of the customer

Example: "1952-05-04"
result[].​emailstring

Email address of the customer

Example: "example@email.com"
result[].​genderstring

Gender of the customer

Enum ValueDescription
MALE

Male gender of the customer

FEMALE

Female gender of the customer

UNISEX

Unisex gender of the customer

Example: "MALE"
result[].​streetstring

Street of the customer

Example: "Am Bahnhof"
result[].​houseNumberstring

Number of the customer's house

Example: 89
result[].​zipCodestring

Zip code of the customer

Example: "12133"
result[].​citystring

City of the customer

Example: "Munich"
result[].​countrystring(ISO 3166-1)

Country of the customer

Example: "DE"
result[].​secondStreetstring

Second street line of the customer's address

Example: "Second Street"
result[].​cityPartstring

City part of the customer's address

Example: "Tegel"
result[].​districtstring

District of the customer's address

Example: "District 12"
result[].​streetTypestring

Street type of the customer's address

Example: "Avenue"
result[].​streetBlockstring

Street block of the customer's address

Example: "5th block"
result[].​portalstring

Portal of the customer's address

Example: "Portal 1"
result[].​stairwaystring

Stairway of the customer's address

Example: "Right stairway"
result[].​doorstring

Door of the customer's address

Example: "Door 1"
result[].​provincestring

Province of the customer's address

Example: "Champagne"
result[].​additionalAddressInformationstring

Additional address information of the customer's address

Example: "Additional information"
result[].​floorstring

Floor of the customer's address

Example: "2nd floor"
result[].​buildingNamestring

Building name

Example: "Empire State Building"
result[].​statusstringrequired

Status of customer

Enum ValueDescription
FORMER_MEMBER

Customer is a former member

PROSPECT

Customer without contracts

MEMBER

Customer with contracts attached

Example: "MEMBER"
result[].​imageUrlstring

Url with an image to download. It will expire after 15 minutes

Example: "https://example.com"
result[].​phonePrivatestring

Private phone number of the customer

Example: "+49 30901820"
result[].​phonePrivateMobilestring

Private mobile phone number of the customer

Example: "+49 15223433333"
result[].​phoneBusinessstring

Business phone number of the customer

Example: "+49 30901820"
result[].​phoneBusinessMobilestring

Business mobile phone number of the customer

Example: "+49 15223433333"
result[].​idlePeriodsArray of objects(CustomerIdlePeriod)

List of customer's idle periods

result[].​accessRefusalbooleanrequired

Indicates whether the customer has an access block currently

result[].​accessRestrictionsArray of objects(AccessRestriction)

List of access restrictions of the customer

result[].​uuidstring

Customer's UUID

Example: "7be3932c-825b-4401-abff-29e9f9410bc7"
result[].​referralCodestring

Customer's referral code

Example: "20J6N"
result[].​studioIdinteger(int64)

Studio ID of the customer

Example: 1238735970
result[].​preferredLanguageobject(Language)

Basic language information

result[].​additionalInformationFieldAssignmentsArray of objects(AdditionalInformationFieldAssignment)

List of additional information field assignments of the customer

result[].​thirdPartyIdstring

Unique ID of the third party customer in the third party system

Example: "A1000"
result[].​createdDateTimestring(date-time)

Customer's creation date time in ISO-8601 format

Example: "2022-06-15T23:59:59.999+02:00[Europe/Berlin]"
result[].​accessMediumsArray of objects(AccessMediumDto)

List of access mediums of the customer

result[].​cardNumbersArray of stringsDeprecated

UID list of the customer card numbers in expected format. (The new property to use is accessMediums)

Example: ["1290158199"]
result[].​bankAccountobject(BankAccount)Deprecated

Customer's bank account information. Deprecated: For fetching bank accounts use the Search customers by payment details endpoint.

hasNextbooleanrequired

True if there exists next data slice

Example: true
offsetstringrequired

Offset for next query (last ID of the customer)

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

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