Accounts

Get Single Wallet Account

Changed on

This API method allows the calling application to retrieve details for a Wallet Account.

get/wallet/{walletId}/account/{accountId}

Request

  • Base URL
    https://wallet.uk.eagleeye.com/2.0
  • URL
    https://wallet.uk.eagleeye.com/2.0/wallet/{walletId}/account/{accountId}
  • Auth
    API key in header X-EES-AUTH-CLIENT-ID and API key in header X-EES-AUTH-HASH

Path parameters

walletIdstring string required

EES AIR Wallet ID

accountIdstring string required

EES AIR Wallet Account ID

Query parameters

includestring[]

A list of entities that should be included in the Account response

tokensboolean

Show up to 100 active Tokens associated with the account.

limitsboolean

Shows information on the limitations on using the account, this data varies per account type. For example, if it's a coupon account you'll see maxRedemptionsRemaining and perPeriodRedemptionsRemaining.

passphraseboolean

If passed then any tokens returned will have their passphrase included. This should be used with caution as the passphrase is designed to be secret (like a PIN number).

relatedAccountsboolean

This determines if related accounts are returned in the response. A collection of related wallet accounts, categorised by objects such as ECOUPON and CONTINUITY. It may also include relationships to other accounts, such as QUEST objects, and is used for multiple accounts.

Response

OK

accountIdstring required

EES AIR Wallet Account ID.

walletIdstring required

EES AIR Wallet ID.

campaignIdstring required

The Campaign ID this account belongs to.

type'ECOUPON' | 'VOUCHER' | 'STAMP_CARD' | 'PAPER' | 'DEBIT' | 'PLASTIC' | 'POINTS' | 'CONTINUITY' | 'STANDARD_SUBSCRIPTION' | 'QUEST' required

EES AIR Account Type.

clientTypestring required

Account client type.

status'ACTIVE' | 'BLOCKED' | 'CANCELLED' | 'DELETED' | 'EXPIRED' | 'INACTIVE' | 'INVALIDATED' | 'LOCKED' | 'STOLEN' | 'USED' | 'SUSPENDED' required

Account Status

statestring required

Account state, managed per retailer base, list of possible enum values could be set-up as part of the Onboarding process.

dateCreatedstring required

Date this Account was created.

lastUpdatedstring required

Date this Account was last updated.

mobileWalletstring required

The URL that returns a digital platform wallet.

Example response

{
  "dates": {
    "start": "2017-01-17T13:20:48+00:00",
    "end": "2017-01-17T13:20:48+00:00"
  },
  "relationships": {
    "ENTITLEMENT": {
      "accountType": [
        {
          "dateCreated": "2017-01-17T13:20:48+00:00"
        }
      ]
    },
    "ENTITLEMENT_OF": {
      "accountType": [
        {
          "dateCreated": "2017-01-17T13:20:48+00:00"
        }
      ]
    },
    "OBJECTIVE": {
      "accountType": [
        {
          "dateCreated": "2017-01-17T13:20:48+00:00"
        }
      ]
    },
    "OBJECTIVE_OF": {
      "accountType": [
        {
          "dateCreated": "2017-01-17T13:20:48+00:00"
        }
      ]
    },
    "PROMOTION": {
      "accountType": [
        {
          "dateCreated": "2017-01-17T13:20:48+00:00"
        }
      ]
    },
    "PROMOTION_OF": {
      "accountType": [
        {
          "dateCreated": "2017-01-17T13:20:48+00:00"
        }
      ]
    },
    "BOUNCE_BACK_REWARD": {
      "accountType": [
        {
          "dateCreated": "2017-01-17T13:20:48+00:00"
        }
      ]
    },
    "BOUNCE_BACK_REWARD_OF": {
      "accountType": [
        {
          "dateCreated": "2017-01-17T13:20:48+00:00"
        }
      ]
    },
    "COUPON_STAMP_REWARD": {
      "accountType": [
        {
          "dateCreated": "2017-01-17T13:20:48+00:00"
        }
      ]
    },
    "COUPON_STAMP_REWARD_OF": {
      "accountType": [
        {
          "dateCreated": "2017-01-17T13:20:48+00:00"
        }
      ]
    },
    "LOYALTY_POINTS_REWARD_OF": {
      "accountType": [
        {
          "dateCreated": "2017-01-17T13:20:48+00:00"
        }
      ]
    }
  },
  "relatedAccounts": [
    {
      "dates": {
        "start": "2017-01-17T13:20:48+00:00",
        "end": "2017-01-17T13:20:48+00:00"
      },
      "relationships": {
        "ENTITLEMENT": {
          "accountType": [
            {
              "dateCreated": "2017-01-17T13:20:48+00:00"
            }
          ]
        },
        "ENTITLEMENT_OF": {
          "accountType": [
            {
              "dateCreated": "2017-01-17T13:20:48+00:00"
            }
          ]
        },
        "OBJECTIVE": {
          "accountType": [
            {
              "dateCreated": "2017-01-17T13:20:48+00:00"
            }
          ]
        },
        "OBJECTIVE_OF": {
          "accountType": [
            {
              "dateCreated": "2017-01-17T13:20:48+00:00"
            }
          ]
        },
        "PROMOTION": {
          "accountType": [
            {
              "dateCreated": "2017-01-17T13:20:48+00:00"
            }
          ]
        },
        "PROMOTION_OF": {
          "accountType": [
            {
              "dateCreated": "2017-01-17T13:20:48+00:00"
            }
          ]
        },
        "BOUNCE_BACK_REWARD": {
          "accountType": [
            {
              "dateCreated": "2017-01-17T13:20:48+00:00"
            }
          ]
        },
        "BOUNCE_BACK_REWARD_OF": {
          "accountType": [
            {
              "dateCreated": "2017-01-17T13:20:48+00:00"
            }
          ]
        },
        "COUPON_STAMP_REWARD": {
          "accountType": [
            {
              "dateCreated": "2017-01-17T13:20:48+00:00"
            }
          ]
        },
        "COUPON_STAMP_REWARD_OF": {
          "accountType": [
            {
              "dateCreated": "2017-01-17T13:20:48+00:00"
            }
          ]
        },
        "LOYALTY_POINTS_REWARD_OF": {
          "accountType": [
            {
              "dateCreated": "2017-01-17T13:20:48+00:00"
            }
          ]
        }
      },
      "dateCreated": "2017-01-17T13:20:48+00:00",
      "lastUpdated": "2017-01-17T13:20:48+00:00"
    }
  ],
  "dateCreated": "2017-01-17T13:20:48+00:00",
  "lastUpdated": "2017-01-17T13:20:48+00:00"
}

Changes

    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response property ////// became optional for the status

    • breaking

      the ///// response's property format changed from date-time to no format for status

    • breaking

      the ///// response's property format changed from date-time to no format for status

    • breaking

      the //// response's property type changed from no type to object for status

    • breaking

      the ////// response's property format changed from date-time to no format for status

    • breaking

      the /////// response's property format changed from date-time to no format for status

    • breaking

      the /////// response's property format changed from date-time to no format for status

    • breaking

      the ////// response's property format changed from date-time to no format for status

    • breaking

      the //////// response's property type changed from object to array for status

    • breaking

      the //////// response's property type changed from object to array for status

    • breaking

      the ////// response's property type changed from object to array for status

    • breaking

      the ////// response's property type changed from object to array for status

    • breaking

      the ////// response's property type changed from object to array for status

    • breaking

      the ////// response's property type changed from object to array for status

    • breaking

      the ////// response's property type changed from object to array for status

    • breaking

      the ////// response's property type changed from object to array for status

    • breaking

      the ////// response's property type changed from object to array for status

    • breaking

      the ////// response's property type changed from object to array for status

    • breaking

      the ////// response's property type changed from object to array for status

    • breaking

      the ////// response's property type changed from object to array for status

    • breaking

      the ////// response's property type changed from object to array for status

    • breaking

      removed the required property ///////// from the response with the status

    • breaking

      removed the required property ///////// from the response with the status

    • breaking

      removed the required property ///////// from the response with the status

    • breaking

      removed the required property ///////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • warning

      removed the optional property ////// from the response with the status

    • warning

      added the new AALR enum value to the //// response property for the response status

    • warning

      added the new AALR enum value to the //// response property for the response status

    • warning

      added the new AALR enum value to the //// response property for the response status

    • warning

      added the new CILR enum value to the //// response property for the response status

    • warning

      added the new CILR enum value to the //// response property for the response status

    • warning

      added the new CILR enum value to the //// response property for the response status

    • warning

      added the new CLPPR enum value to the //// response property for the response status

    • warning

      added the new CLPPR enum value to the //// response property for the response status

    • warning

      added the new CLPPR enum value to the //// response property for the response status

    • warning

      added the new CONTINUITY enum value to the ////// response property for the response status

    • warning

      added the new ELE enum value to the //// response property for the response status

    • warning

      added the new ELE enum value to the //// response property for the response status

    • warning

      added the new ELE enum value to the //// response property for the response status

    • warning

      added the new POINTS enum value to the ////// response property for the response status

    • warning

      added the new QUEST enum value to the ////// response property for the response status

    • warning

      added the new RF enum value to the //// response property for the response status

    • warning

      added the new RF enum value to the //// response property for the response status

    • warning

      added the new RF enum value to the //// response property for the response status

    • warning

      added the new RFL enum value to the //// response property for the response status

    • warning

      added the new RFL enum value to the //// response property for the response status

    • warning

      added the new RFL enum value to the //// response property for the response status

    • warning

      added the new STAMP_CARD enum value to the ////// response property for the response status

    • warning

      added the new STANDARD_SUBSCRIPTION enum value to the ////// response property for the response status

    • warning

      added the new SUSPENDED enum value to the ////// response property for the response status

    • warning

      added the new TBR enum value to the //// response property for the response status

    • warning

      added the new TBR enum value to the //// response property for the response status

    • warning

      added the new TBR enum value to the //// response property for the response status

    • warning

      added the new TBS enum value to the //// response property for the response status

    • warning

      added the new TBS enum value to the //// response property for the response status

    • warning

      added the new TBS enum value to the //// response property for the response status

    • warning

      added the new WLNF enum value to the //// response property for the response status

    • warning

      added the new WLNF enum value to the //// response property for the response status

    • warning

      added the new WLNF enum value to the //// response property for the response status

    • warning

      added the new WTF enum value to the //// response property for the response status

    • warning

      added the new WTF enum value to the //// response property for the response status

    • warning

      added the new WTF enum value to the //// response property for the response status

    • warning

      added the new WTNF enum value to the //// response property for the response status

    • warning

      added the new WTNF enum value to the //// response property for the response status

    • warning

      added the new WTNF enum value to the //// response property for the response status

    • info

      added to the response body allOf list for the response status

    • info

      added to the response body allOf list for the response status

    • info

      removed from the response body allOf list for the response status

    • info

      removed from the response body allOf list for the response status

    • info

      removed from the response body allOf list for the response status

    • info

      removed from the response body allOf list for the response status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response's property default value ACTIVE was added for the status

    • info

      removed from the //// response property oneOf list for the response status

    • info

      the ///// response's property pattern /\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2]\d|3[0-1])T[0-2]\d:[0-5]\d:[0-5]\d[+-][0-2]\d:[0-5]\d/ was added for the status

    • info

      the ///// response's property pattern /\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2]\d|3[0-1])T[0-2]\d:[0-5]\d:[0-5]\d[+-][0-2]\d:[0-5]\d/ was added for the status

    • info

      the ////// response's property pattern /\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2]\d|3[0-1])T[0-2]\d:[0-5]\d:[0-5]\d[+-][0-2]\d:[0-5]\d/ was added for the status

    • info

      the /////// response's property pattern /\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2]\d|3[0-1])T[0-2]\d:[0-5]\d:[0-5]\d[+-][0-2]\d:[0-5]\d/ was added for the status

    • info

      the /////// response's property pattern /\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2]\d|3[0-1])T[0-2]\d:[0-5]\d:[0-5]\d[+-][0-2]\d:[0-5]\d/ was added for the status

    • info

      the ////// response's property pattern /\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2]\d|3[0-1])T[0-2]\d:[0-5]\d:[0-5]\d[+-][0-2]\d:[0-5]\d/ was added for the status

    • info

      added the required property ////// to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    This list may be incomplete.