Skip to content
Magicline Open API
/
API reference
/
/
Post customer's benefit u...

Magicline API (1.13.2)

  • 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
  • Get device information
  • Employee operations
  • Debt collection operations
  • Leads operations
  • 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.magicline.com/

Mock server

https://redocly.sportalliance.com/_mock/apis/magicline/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

Post customer's benefit usage

Request

Required Scopes(any of): CUSTOMER_WRITE, CUSTOMER_BENEFIT_WRITE

Security
ApiKeyAuth
Path
customerIdinteger(int64)required

Unique ID of the customer

benefitKeystringrequired

Key of the benefit to use

curl -i -X POST \
  'https://open-api-demo.open-api.magicline.com/v1/customers/{customerId}/benefits/{benefitKey}/use' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

Benefit has been used.

Response
No content

Post customer's benefit usage by

Request

Required Scopes(any of): CUSTOMER_WRITE, CUSTOMER_BENEFIT_WRITE

Uses customer's benefit identified by one of the given parameters: card number, barcode or pin. Exactly one identifier must be provided.

Security
ApiKeyAuth
Path
benefitKeystringrequired

Key of the benefit to use

Query
cardNumberstring

Card number to identify the customer

cardNumberFormatstring(CardNumberFormat)

Defines how card numbers are interpreted

Default "DECIMAL"
Enum"DECIMAL""HEX_MSB""HEX_LSB"
barcodestring

Barcode to identify the customer

pinstring

PIN to identify the customer

curl -i -X POST \
  'https://open-api-demo.open-api.magicline.com/v1/customers/benefits/{benefitKey}/use?cardNumber=string&cardNumberFormat=DECIMAL&barcode=string&pin=string' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

Benefit has been used.

Response
No content

Get customer's access code

Request

Required Scopes: CUSTOMER_READ

Returns customer's access code

Security
ApiKeyAuth
Path
customerIdinteger(int64)required

Unique ID of the customer

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

Responses

OK

Bodyapplication/json
formatstringrequired

Represents an access code format the content should be encoded into or decoded from

ValueDescription
QR_CODE

QR code format

Example: "QR_CODE"
expiresAtstring(date-time)

Access code expiry date and time with zone

Example: "2024-06-13T10:33:00Z"
contentstringrequired

Access code content that should be rendered in a format defined by the format property

Example: "0049267681211943991"
Response
application/json
{
  "format": "QR_CODE",
  "expiresAt": "2024-06-13T10:33:00Z",
  "content": "0049267681211943991"
}

Customers Account

Retrieve customer accounting details

Operations

Customers Communication

Retrieve customer communication details

Operations

Customers Self-service

Operations

Devices

Get device information

Operations

Employees

Employee operations

Operations

Finance

Debt collection operations

Operations

Leads

Leads operations

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