Skip to content

Scope of this API

This API can be used to integrate Magicline operations into third party clients like websites or apps.

Following operations are supported

  • Online contract conclusion
  • Trial session slot booking
  • Lead creation
Download OpenAPI description
Languages
Servers
Generated server url

https://connectdemo.api.magicline.com/

Mock server

https://redocly.sportalliance.com/_mock/apis/magicline/connectapi/connectapi/

Campaigns

List your marketing campaigns

Operations
Operations

TrialSessions

Allow prospects to book a trial session

Operations
Operations

Referral

Additional referral information for member creation

Operations

Image

Allow prospect to upload image

Operations

Promotions

Getting information about external promotion participation

Operations
Operations
Operations

Redeem a ContractVoucher. Only Vouchers of type 'Rate' are supported here.

Request

Path
contractVoucherCodestringrequired
Bodyapplication/jsonrequired
contractStartDatestring(date)
contractStartPreuseDatestring(date)
customerDtoobject(ConnectApiCreatePublicCustomerDto)
organizationUnitIdinteger(int64)
curl -i -X POST \
  'https://connectdemo.api.magicline.com/connect/v1/contractvoucher/{contractVoucherCode}/redeem' \
  -H 'Content-Type: application/json' \
  -d '{
    "contractStartDate": "2019-08-24",
    "contractStartPreuseDate": "2019-08-24",
    "customerDto": {
      "additionalAddressInformation": "string",
      "bankAccount": {
        "accountHolder": "string",
        "bic": "string",
        "iban": "string"
      },
      "buildingName": "string",
      "city": "Hamburg",
      "cityPart": "string",
      "communicationPreferences": [
        {
          "activeCommunicationChannels": [
            "LETTER"
          ],
          "messageCategoryId": 0
        }
      ],
      "countryCode": "DE",
      "countryOfBirth": "UNDEFINED",
      "creditCard": {
        "accountPaymentInstrumentToken": "string",
        "tokenizationReference": "string"
      },
      "dateOfBirth": "2019-08-24",
      "district": "string",
      "documentIdentification": {
        "documentNumber": "string",
        "documentType": "ID_CARD"
      },
      "door": "string",
      "email": "string",
      "firstname": "string",
      "floor": "string",
      "gender": "MALE",
      "houseNumber": "3-4",
      "identification": {
        "spain_DNI_NIE": "string"
      },
      "identityToken": "2340b1cc-3fe7-4f81-8eca-f92181dd2bb4",
      "imageObjectKey": "string",
      "language": "string",
      "lastname": "string",
      "locale": "string",
      "paymentChoice": "DIRECT_DEBIT",
      "placeOfBirth": "string",
      "portal": "string",
      "privacyConfiguration": {
        "email": true,
        "letter": true,
        "mySportsMessage": true,
        "phone": true,
        "textMessage": true
      },
      "province": "string",
      "provinceCode": "string",
      "publicGender": "MALE",
      "referralCode": "string",
      "secondFirstname": "string",
      "secondLastName": "string",
      "secondStreet": "string",
      "stairway": "string",
      "street": "Raboisen",
      "streetBlock": "string",
      "streetType": "string",
      "studioCountryCode": "UNDEFINED",
      "taxId": "string",
      "telephone_mobile": "string",
      "telephone_private": "string",
      "zipCode": 22099
    },
    "organizationUnitId": 0
  }'

Responses

OK

Body*/*
customerNumberstring

Validates a ContractVoucher and returns basic voucher information to display. Only Vouchers of type 'Rate' are supported here.

Request

Path
contractVoucherCodestringrequired
Query
organizationUnitIdinteger(int64)required
curl -i -X GET \
  'https://connectdemo.api.magicline.com/connect/v1/contractvoucher/{contractVoucherCode}/validate?organizationUnitId=0'

Responses

OK

Body*/*
rateDetailTermstring
rateNamestring
validityPeriodobject(OpenTimePeriodClientDto)
Operations
Operations

CreditCard Tokenization

Store credit cards for new members

Operations
Operations
Operations
Operations
Operations
Operations
Operations