Pricing Query

Overview

DragonPass provides a set of Pricing Query APIs that allow clients to retrieve pricing information at both the resource level and the option level.

The current pricing APIs support only a single settlement price model. Support for additional settlement models will be added soon.

All returned prices are based on the contractually agreed settlement prices between DragonPass and the client. Clients have full flexibility to determine how these prices are displayed to their end users within your own applications.

Resource-Level Pricing Query

→ /resources/prices

This endpoint applies to modules where the price is configured at the resource level:

Lounge

Fast Track

Set Meal

Coupon

Please note that when performing a batch query, if some resources are not included in the client’s authorized price list, those resources will not be returned in the response.

Request

Retrieve Resource Pricing Information - Request

{
    "module": 1,
    "resources": [
        "N00001"
    ],
    "pageNumber": 1,
    "pageSize": 10
}

Response

Retrieve Resource Pricing Information - Response

{
    "code": 0,
    "data": {
        "pagination": {
            "pageSize": 10,
            "pageNumber": 1,
            "totalNumber": 1
        },
        "resources": [
            {
                "resourceId": "N00001",
                "resourceName": "Manchester Airport Lounge",
                "currency": "USD",
                "lastUpdatedTime": "2025-05-01T10:00:00+00:00",
                "pricingMode": 1,
                "pricing": {
                    "basePrice": 50,
                    "prebookingFee": 5
                }
            }
        ]
    }
}

Option-Level Static Pricing Query

→ resources/options/prices

This endpoint applies to modules where the price is defined at the option level, not at the resource level, and the returned prices are static and do not change in real time:

eSIM

Please note that when performing a batch query, if some options are not included in the client’s authorized price list, those options will not be returned in the response.

Request

Retrieve Prebooking Option Pricing Information - Request

{
    "module": 1,
    "resourceId": "E00001",
    "options": [
        "E00001-02"
    ],
    "pageNumber": 1,
    "pageSize": 10
}

Response

Retrieve Prebooking Option Pricing Information - Response

{
    "code": 0,
    "data": {
        "pagination": {
            "pageSize": 10,
            "pageNumber": 1,
            "totalNumber": 1
        },
        "resourceId": "E00001",
        "resourceName": "eSIM United Kingdom",
        "options": [
            {
                "optionId": "E00001-02",
                "optionName": "eSIM United Kingdom - 10GB 5Days",
                "currency": "USD",
                "lastUpdatedTime": "2025-05-01T10:00:00+00:00",
                "pricingMode": 1,
                "pricing": {
                    "basePrice": 50,
                    "prebookingFee": null
                }
            }
        ]
    }
}

Option-Level Dynamic Pricing Query

For certain modules, the pricing is defined at the option level rather than the resource level, and the prices may fluctuate over time.

Fitness

In the existing Retrieve Fitness Resources Schedule /resources/fitness/{resourceId}/schedule endpoint, we have added a new control parameter that allows clients to specify whether to include pricing information when fetching the schedule.

When the expand=price parameter is added, the response will include additional price-related information.

"price": {
    "currency": "USD",
    "lastUpdatedTime": "2025-10-01T10:00:00+00:00",
    "pricingMode": 1,
    "pricing": {
        "basePrice": 25.0,
        "prebookingFee": null
    }
}

Response

Retrieve Fitness Resources Schedule - Response

{
    "code": 0,
    "data": {
        "resourceId": "F00001",
        "resourceName": "DragonPass Fitness Club",
        "schedules": [
            {
                "date": "2025-10-01",
                "optionList": [
                    {
                        "optionId": "F00001-01",
                        "optionName": "Hatha Yoga",
                        "optionType": 2,
                        "startTime": "10:00",
                        "endTime": "11:00",
                        "price": {
                            "currency": "USD",
                            "lastUpdatedTime": "2025-10-01T10:00:00+00:00",
                            "pricingMode": 1,
                            "pricing": {
                                "basePrice": 25.0,
                                "prebookingFee": null
                            }
                        }
                    },
                    {
                        "optionId": "F00001-02",
                        "optionName": "Hatha Yoga",
                        "optionType": 2,
                        "startTime": "11:00",
                        "endTime": "12:00",
                        "price": {
                            "currency": "USD",
                            "lastUpdatedTime": "2025-10-01T10:00:00+00:00",
                            "pricingMode": 1,
                            "pricing": {
                                "basePrice": 25.0,
                                "prebookingFee": null
                            }
                        }
                    },
                    {
                        "optionId": "F00001-dayPass",
                        "optionName": "Day Pass",
                        "optionType": 1,
                        "startTime": "08:00",
                        "endTime": "20:00",
                        "price": {
                            "currency": "USD",
                            "lastUpdatedTime": "2025-10-01T10:00:00+00:00",
                            "pricingMode": 1,
                            "pricing": {
                                "basePrice": 10.0,
                                "prebookingFee": null
                            }
                        }
                    }
                ]
            }
        ]
    }
}

Overview#

Resource-Level Pricing Query#

Option-Level Static Pricing Query#

Option-Level Dynamic Pricing Query#

Fitness#

Overview

Resource-Level Pricing Query

Option-Level Static Pricing Query

Option-Level Dynamic Pricing Query

Fitness