Fitness

Kindly note that currently each Fitness prebooking order allows only one person.

For lifestyle-related services, such as Fitness and eSIM, each resource (e.g., a specific fitness club or an eSIM for a certain region) may offer multiple options (e.g., different fitness classes or data plans). Orders are created at the option level under the corresponding resource.

Fitness Prebooking

The prebooking process follows these main steps:

Retrieve Option List

Retrieve the list of available options for a specific resource.

Availability Check

Query the availability of a specific option within a given resource for the specified date and time.

Prebooking Creation

If available, a prebooking order can be created. The order remains cancellable within the applicable cancellation policy window.

Check-in

Upon arrival at the service location, the user must complete a check-in via the designated API. Successful check-in will return the service voucher required for access.

Service Access

At the prebooking time, the user can access the service by presenting the voucher provided in the order check-in.

→ Use /orders/fitness/ePasses/prebooking to place a Fitness prebooking order with an E-pass.

Request

Create E-pass Prebooking Order - Fitness - Request

As required by airports and partners, certain resource prebooking orders will need the passenger's name, email, phone number, or flight number for booking information.
For the required information at specific locations, please refer to theprebookingRequiredInfoprovided in the /resources/{resourceId} response.

According to the requirements of the service resources, DragonPass only collects the necessary personally identifiable information (PII) for each order.

Even if clients provide additional or unnecessary PII, we will not store it. Such data will be discarded and displayed as null in the order details.

{
    "module": 7,
    "ePassId": "1788000066668888",
    "extra": {
        "prebookingToken": "85c69b8e790befc7e94870ec269c3f1d",
        "prebookingRequiredInfo": {
            "firstName": "DragonPass",
            "lastName": "DragonPass",
            "email": "developer@dragonpass.com",
            "phoneNumber": "8081966002",
            "callingCode": "44"
        }
    }
}

Response

Create E-pass Prebooking Order - Fitness - Response

{
    "code": 0,
    "data": {
        "status": 1,
        "module": 7,
        "category": 2,
        "ePassId": "1788000066668888",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
            "prebookingDate": "2025-10-01T10:30",
            "usageDate": null,
            "usedUsages": 1,
            "resourceId": "F00001",
            "resourceName": "DragonPass Fitness Club",
            "city": "Manchester",
            "countryOrRegion": "GB",
            "vouchersList": [
                {
                    "voucher": "668800008888",
                    "voucherType": 1
                }
            ],
            "prebookingRequiredInfo": {
                "firstName": "DragonPass",
                "lastName": "DragonPass",
                "email": "developer@dragonpass.com",
                "phoneNumber": "8081966002",
                "callingCode": "44",
                "transportNumber": "string"
            },
            "fitnessOptions": {
                "optionId": "F00001-01",
                "optionName": "Day Pass",
                "optionType": 1,
                "startTime": "10:00",
                "endTime": "11:00",
                "description": "Book a day pass for gym access anytime during opening hours on your chosen date.",
                "highlights": [
                    "Full access to all gym facilities."
                ],
                "language": [
                    "English"
                ],
                "includes": [
                    "Bottle of water"
                ],
                "excludes": [
                    "Sportswear"
                ],
                "notes": [
                    "Please check-in at least 20 min before the class starts."
                ]
            }
        }
    }
}

Check-in

→ Use /orders/fitness/checkin endpoint to complete check-in.

Request

Fitness Order Check-In - Request

{
  "orderId": "DP00000000000001"
}

Response

After a successful check-in, the service voucher will be returned in the response.

Fitness Order Check-In - Response

{
    "code": 0,
    "data": {
        "orderId": "DP00000000000001",
        "status": 2,
        "vouchersList": [
            {
                "voucher": "668800008888",
                "voucherType": 1
            }
        ]
    }
}

Cancel Prebooking Orders

→ Use the /orders endpoint to cancel a prebooking order by order ID.

A prebooking order can be cancelled in accordance with the cancellation policy. Once cancelled, the corresponding usages will be refunded to the E-pass.

Whether a prebooking order can be canceled depends on the cancellation policy provided in the /resources/{resourceId} response, usually:

24-72 hours before the service time.

Please note that once a prebooking order is cancelled, it cannot be recovered.

Fitness Prebooking#

Check-in#

Cancel Prebooking Orders#

Fitness Prebooking

Check-in

Cancel Prebooking Orders