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.Resource-Level Pricing Query — for modules where pricing is defined at the resource level, such as Lounge and Fast Track. For example, a lounge or Fast Track service is the resource itself, and pricing is provided directly at the resource level.Option-Level Static Pricing Query — for modules such as eSIM, where the resource represents a location/coverage area (e.g. a country), while pricing is defined at the option level, with each option representing a specific data package.Option-Level Dynamic Pricing Query — for modules such as Fitness, where the resource represents a physical location (e.g. a gym), while pricing is defined at the option level, with each option representing a specific class or access option. Pricing may vary over time.Resource-Level Pricing Query#
This endpoint applies to modules where the price is configured at the resource level: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.
All returned settlement prices are based on the contractually agreed 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.
Retrieve Resource Pricing Information - Request
{
"module": 1,
"resources": [
"N00001"
],
"pageNumber": 1,
"pageSize": 10
}
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.5
},
"pricing": {
"basePrice": {
"settlement": 50,
"selling": 60
},
"prebookingFee": {
"chargingRule": "USER_FULL_PAYMENT",
"settlement": 5.5,
"selling": 5.5
}
}
}
]
}
}
Option-Level Static Pricing Query#
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: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.
Retrieve Prebooking Option Pricing Information - Request
{
"module": 1,
"resourceId": "E00001",
"options": [
"E00001-02"
],
"pageNumber": 1,
"pageSize": 10
}
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": 5.5,
"prebookingFee": null
},
"pricing": {
"basePrice": {
"settlement": 5.5,
"selling": 6.5
},
"prebookingFee": {
"chargingRule": null,
"settlement": null,
"selling": 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.