DragonPass API Developer Platform
v2
  • v2
  • v1
Homepage
Official SiteContact Us
Homepage
Official SiteContact Us
API Version
v2
  • v2
  • v1
v2
  • v2
  • v1
  1. E-pass Management
  • Implementation Guide
    • Get Started
    • Our API Solution
    • DragonPass Modules
  • Development Guide
    • Authentication
    • Response Format
    • Error Codes
    • Order Lifecycle
    • Multiple Language Support and Fallback
    • Sandbox Order Simulation
    • UI Design Guidelines
  • Using the API
    • Search for Resources
      • Search for Resources
      • Check Prebooking Resource & Option Availability
      • Pricing Query
      • Image Parameters
    • E-pass
      • Issuing, Querying, and Cancelling an E-pass
      • Querying E-pass Usage Orders and Details
      • Utilizing The E-pass
        • Lounge
        • Fast Track
        • Dining
        • Cross Module
        • Fitness
        • eSIM
    • Membership
      • Manage Memberships & Entitlements
      • Querying Membership Usage Orders and Details
      • Utilizing DragonPass Membership
        • Lounge
        • Fast Track
        • Dining
        • Fitness
        • eSIM
    • User
      • User Management
  • Push Event
    • Lounge/Dining Walk-in Redemption Event
    • Prebooking Order Status Change Event
    • Instructions
    • Resource Update Push Service
  • Release Notes
    • 2025
    • 2026
  • Migration Guide
    • From V1 to V2
  • API Reference
    • Authentication
      • Generate Access Token
    • Search
      • Aggregated Search by Keyword
      • Retrieve Available Modules by Location
    • Transport Hubs
      • Retrieve Transport Hub
      • Retrieve Transport Hub Details
    • Resources
      • Resource List
        • Retrieve Resources List
      • Resource Details
        • Retrieve Resource Details
      • Check Resource Availability
        • Check Prebooking Resource Availability
        • Check Prebooking Option Availability
      • Fitness
        • Retrieve Fitness Resource Option Details
        • Retrieve Fitness Resources Schedule
      • eSIM
        • Retrieve eSIM Resource Option Details
        • Retrieve eSIM Resouces Options
      • Pricing
        • Retrieve Resource Pricing Information
        • Retrieve Prebooking Option Pricing Information
    • User Management
      • User Creation
      • Update User Information
      • Delete A User
      • Retrieve User Information
      • Retrieve User Memberships List
      • Retrieve User E-passes List
    • E-pass
      • E-pass Management
        • Create E-pass Order
          POST
        • Retrieve E-pass Details
          POST
        • Cancel an E-pass
          PATCH
      • Orders & Usage
        • Create Orders
          • Lounge Prebooking
            • Create E-pass Prebooking Order - Lounge
            • Create E-pass with Prebooking Order - Lounge
          • Fast Track
            • Create E-pass Prebooking Order - Fast Track
            • Create E-pass with Prebooking Order - Fast Track
          • Fitness
            • Create E-pass Prebooking Order - Fitness
            • Create E-pass with Prebooking Order - Fitness
          • eSIM
            • Create E-pass Prebooking Order - eSIM
            • Top up eSIM data package - E-pass
            • Create E-pass with Prebooking Order - eSIM
        • Retrieve Order List
          • Retrieve E-pass Order List
        • Cancel Orders
          • Cancel an Order
        • Module Specific APIs
          • Fitness
            • Fitness Order Check-In
          • eSIM
            • Retrieve eSIM Data Packages
            • Check eSIM Top-up Availability
            • Retrieve eSIM Order Live Extended Details
        • Usage Details
          • Retrieve E-pass Usage Order Details
    • Membership & Entitlement
      • Membership Lifecycle
        • Membership Registration
        • Update A Membership
        • Retrieve Membership Information
        • Generate Membership Dynamic QR Codes
      • Entitlement Management
        • Update Membership Entitlements
        • Retrieve Membership Entitlement Information
      • Orders & Usage
        • Preview Orders
          • Preview Membership Prebooking Order
        • Create Orders
          • Create Membership Prebooking Order - Lounge
          • Create Membership Prebooking Order - Fast Track
          • Create Membership Prebooking Order - Fitness
          • Create Membership Prebooking Order - eSIM
          • Top up eSIM data package - Membership
        • Cancel Orders
          • Cancel an Order
        • Retrieve Order List
          • Retrieve Membership Order List
        • Usage Details
          • Retrieve Membership Usage Order Details
        • Module Specific APIs
          • Fitness
            • Fitness Order Check-In
          • eSIM
            • Retrieve eSIM Order Live Extended Details
            • Check eSIM Top-up Availability
            • Retrieve eSIM Data Packages
    • Push Event Recovery
      • Push Event Recovery
    • [Sandbox Only] Simulation
      • Lounge
        • Simulate Lounge Redemption - Walk in
        • Simulate Lounge Redemption - Prebooking
        • Simulate Lounge Order Cancellation
      • Fast Track
        • Simulate Fast Track Redemption - Prebooking
        • Simulate Fast Track Order Cancellation
  • Our Team
Homepage
Official SiteContact Us
Homepage
Official SiteContact Us
API Version
v2
  • v2
  • v1
v2
  • v2
  • v1
  1. E-pass Management

Create E-pass Order

POST
https://developer-sandbox.dragonpass.com/api/v2/orders/{module}/ePasses
Last modified:2026-03-31 04:06:55
This API allows corporate clients to issue DragonPass E-passes and configure their available usages and validity periods.
Within allowedResources, only one of resourceIds, iata, or countryOrRegion can be specified at a time, as these conditions are mutually exclusive.
Using the sameclientUserIdto create E-passes with different names is not allowed and will result in a validation error.

Request

Authorization
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Path Params

Header Params

Body Params application/json

Example
{
    "module": 1,
    "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
    "extra": {
        "firstName": "DragonPass",
        "lastName": "DragonPass",
        "activationDate": "2028-12-31T23:59:59+00:00",
        "expirationDate": "2028-12-31T23:59:59+00:00",
        "availableUsages": 1,
        "allowedResources": {
            "resourceIds": [
                "N00001"
            ],
            "iata": [
                "MAN"
            ],
            "countryOrRegion": [
                "GB"
            ]
        }
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://developer-sandbox.dragonpass.com/api/v2/orders/lounges/ePasses' \
--header 'X-Program-ID: ' \
--header 'X-Request-ID: {{$string.uuid}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "module": 1,
    "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
    "extra": {
        "firstName": "DragonPass",
        "lastName": "DragonPass",
        "activationDate": "2028-12-31T23:59:59+00:00",
        "expirationDate": "2028-12-31T23:59:59+00:00",
        "availableUsages": 1,
        "allowedResources": {
            "resourceIds": [
                "N00001"
            ],
            "iata": [
                "MAN"
            ],
            "countryOrRegion": [
                "GB"
            ]
        }
    }
}'

Responses

🟢200Lounge
application/json
Body

Examples
{
    "code": 0,
    "data": {
        "status": 1,
        "module": 1,
        "category": 3,
        "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
        "orderId": "DP00000000000001",
        "orderCreatedDate": "2024-12-31T00:00:00+00:00",
        "orderCancelledDate": null,
        "extra": {
            "ePassId": "1788000066668888",
            "ePassStatus": 0,
            "firstName": "DragonPass",
            "lastName": "DragonPass",
            "activationDate": "2028-10-31T23:59:59+00:00",
            "expirationDate": "2028-12-31T23:59:59+00:00",
            "availableUsages": 1,
            "usedUsages": 0,
            "allowedResources": {
                "resourceIds": []
            }
        }
    }
}
🟢200Fast Track
🟢200Set Meal(Lounge Alternative)
🟢200Dining Coupon
🟢200Fitness
🟢200eSIM
🟢200Cross Module
Modified at 2026-03-31 04:06:55
Previous
Retrieve User E-passes List
Next
Retrieve E-pass Details