Loyalty Transaction Points

Description

This service enables users to Retrieve Loyalty Process Transaction Points Based on the reservationNumber. This number is provided in the response body from your /v1/guestcheckout/process call. 

 back to top

HTTP Method and Request URL

GET

https://api.bloomingdales.com/customer/v1/loyalties?reservationNumber=123456789

back to top

HTTP, Path and Query Parameters

HTTP Header Parameters

Parameter Description Mandatory Sample Value
x-macys-webservice-client-id Pass the apikey as a header value which is called x-macys-webservice-client-id. The api key is the 24 character alphanumeric string assigned to your application when you registered it. 
Click here for a list of your API keys.
Yes xmj9js4jkdpe1983fmwu98gh
Accept Specifies the output format. Can be application/json or application/xml. Yes application/json

Request Body Parameters
Parameter Description Mandatory Sample Value
ReservationNumber This number is provided in the response body from your /v1/guestcheckout/process call  Yes  
123456789

back to top

Sample Requests and Responses

Request URL:

GET

 https://api.bloomingdales.com/customer/v1/loyalties?reservationNumber=123456789

Sample Header:

x-macys-webservice-client-id: xmj9js4jkdpe1983fmwu98gh
x-macys-clientId: client_id
Accept: application/json

 

Request Body(Payload)

 

 

Sample Response

{
    "loyalty": {
        "id": "L900003185478",
        "firstName": "JEFF",
        "lastName": "BLOOMIE",
        "email": "JEFFBLOOMIE@AOL.COM",
        "program": {
            "programCode": "LTYBLM001",
            "offerOnlyFlag": false,
            "tierName": "A-LIST",
            "rewardCurrency": "POINT",
            "rewardThresholdForAward": 5000,
            "awardValue": 25
        },
        "accountStatus": {
            "accountStatus": "A",
            "accountStatusReason": "Active"
        },
        "rewards": [
            {
                "programCode": "LTYBLM001",
                "rewardCurrency": "POINT",
                "rewardsToNextAward": 0,
                "earningLevel": 0,
                "rewardInfos": [
                    {
                        "balanceType": "BLM",
                        "rewardBalance": -1138,
                        "pendingRewardBalance": 3187,
                        "rewardsEarned": 0,
                        "pendingRewardsEarned": 643,
                        "pendingRewards": 0
                    },
                    {
                        "balanceType": "BONUS",
                        "rewardBalance": 0,
                        "pendingRewardBalance": 0,
                        "rewardsEarned": 0,
                        "pendingRewardsEarned": 0,
                        "pendingRewards": 0
                    },
                    {
                        "balanceType": "PWRPOINT",
                        "rewardBalance": 0,
                        "pendingRewardBalance": 0,
                        "rewardsEarned": 0,
                        "pendingRewardsEarned": 0,
                        "pendingRewards": 0
                    }
                ],
                "otherRewards": [
                    {
                        "rewardType": "AMEX",
                        "rewardStatus": "CURRENT",
                        "totalAmount": 0,
                        "totalBonusAmount": 0
                    }
                ]
            }
        ],
        "award": {
            "amount": 0,
            "awardUpdatedFlag": false,
            "awardAmountUsed": 0
        }
    }
}

 

back to top

Error Codes

Call Specific Error Codes:

Error Scenario
Error Code
Reservation number not found. 07047
Reward points not available. 07048

 

General Error Handling Documentation:

Click Here

back to top

Docs Navigation