Skip to content

User Management API (v2)

Download OpenAPI description
Languages
Servers
Sandbox URL
https://api-ext-sboxmeta.partners.spotnana.com
Spotnana mock server
https://developer.spotnana.com/_mock/openapi/usersapi

Users

APIs to onboard and manage users.

Operations

Get user membership info

Request

Security
Bearer
Path
userIdstring(uuid)required

Identifier for user.

Example: 4974a66b-7493-4f41-908c-58ba81093947
curl -i -X GET \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/users/4974a66b-7493-4f41-908c-58ba81093947/membership-info \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json
membershipInfosArray of objects(LoyaltyInfo)
isLoyaltyBlockedboolean

Whether user is blocked to use loyalty programs. This is a read only field.

Example: false
Response
application/json
{ "membershipInfos": [ {} ], "isLoyaltyBlocked": false }

Update user membership info

Request

Security
Bearer
Path
userIdstring(uuid)required

Identifier for user.

Example: 4974a66b-7493-4f41-908c-58ba81093947
Bodyapplication/jsonrequired
membershipInfosArray of objects(LoyaltyInfo)
isLoyaltyBlockedboolean

Whether user is blocked to use loyalty programs. This is a read only field.

Example: false
curl -i -X PUT \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/users/4974a66b-7493-4f41-908c-58ba81093947/membership-info \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "membershipInfos": [
      {
        "appliedTo": [
          "TAJ"
        ],
        "id": "firstId",
        "issuedBy": "firstIssuedBy",
        "type": "AIR",
        "linked": false,
        "tier": "GOLD"
      }
    ],
    "isLoyaltyBlocked": false
  }'

Responses

No Content

Response
No content

Get Marriott Bonvoy account info

Request

This endpoint gets Marriott Bonvoy account info for a user.

Security
Bearer
Path
userIdstring(uuid)required

User ID.

Example: f49d00fe-1eda-4304-ba79-a980f565281d
curl -i -X GET \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/users/f49d00fe-1eda-4304-ba79-a980f565281d/marriott-bonvoy-member-data \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json
activeCoBrandCardHolderstring

Whether the user is an active co-brand card holder.

Example: "Y"
alternateCustomerIdstring

Alternate Marriott ID

Example: "ADA0555952BAEA2001CE5855074B12094.01"
eliteLevelstring(EliteLevel)

Elite level description of Marriott Bonvoy member

Enum"MEMBER""SILVER""GOLD""PLATINUM""TITANIUM""AMBASSADOR"
eliteLevelIdstring

Marriott elite level id (R, S, G, P). Stable across member locales.

Example: "S"
eliteLevelDescriptionstring

Elite level display text, localized by Marriott and passed through as-is.

Example: "Silver Elite"
isCardHolderboolean

Whether the member holds an active Marriott co-brand credit card. Derived from activeCoBrandCardHolder.

Example: true
pointBalanceinteger

Point balance of Marriott Bonvoy member. Can be negative.

Example: 2000
accountStatusstring

Account status of Marriott Bonvoy member

Example: "Active"
Response
application/json
{ "activeCoBrandCardHolder": "Y", "alternateCustomerId": "ADA0555952BAEA2001CE5855074B12094.01", "eliteLevel": "MEMBER", "eliteLevelId": "S", "eliteLevelDescription": "Silver Elite", "isCardHolder": true, "pointBalance": 2000, "accountStatus": "Active" }

Roles

Operations