Membership Registration

POST

https://developer-sandbox.dragonpass.com/api/v2/memberships

Last modified:2025-12-25 07:55:01

This API enables corporate clients to register memberships on the DragonPass platform.

When an activation time is set, the Membership will stay in pending status first.

Our system checks for scheduled activations every 30 minutes and automatically activates any memberships whose activation time is within the next 30 minutes.

This design helps ensure a smooth and consistent activation process for all users, even when many memberships are being created at the same time.

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Example

{
    "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
    "firstName": "DragonPass",
    "lastName": "DragonPass",
    "phoneNumber": "8081966002",
    "callingCode": "44",
    "email": "developer@dragonpass.com",
    "activationDate": "2028-10-31T23:59:59+00:00",
    "expirationDate": "2028-12-31T23:59:59+00:00"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://developer-sandbox.dragonpass.com/api/v2/memberships' \
--header 'X-Program-ID;' \
--header 'X-Request-ID;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
    "firstName": "DragonPass",
    "lastName": "DragonPass",
    "phoneNumber": "8081966002",
    "callingCode": "44",
    "email": "developer@dragonpass.com",
    "activationDate": "2028-10-31T23:59:59+00:00",
    "expirationDate": "2028-12-31T23:59:59+00:00"
}'

Responses

🟢200Success

application/json

Body

Examples

SuccessException

{
    "code": 0,
    "data": {
        "programId": "1876920048220766208",
        "clientUserId": "3EF5D065-76F8-4D3E-801A-B329D15F461A",
        "membershipId": "8888000066668888",
        "status": 1,
        "registrationDate": "2025-01-31T23:59:59+00:00",
        "activationDate": "2028-10-31T23:59:59+00:00",
        "expirationDate": "2028-12-31T23:59:59+00:00",
        "entitlements": {
            "moduleExclusiveEntitlements": [
                {
                    "module": 1,
                    "details": {
                        "cardholderExclusiveEntitlements": 1,
                        "guestsExclusiveEntitlements": 1,
                        "sharedEntitlements": 0,
                        "allowedGuestsPerUsage": 1,
                        "maxGuestsNextUse": 1
                    }
                }
            ]
        }
    }
}

Modified at 2025-12-25 07:55:01

Retrieve Membership Entitlement Information

Update A Membership