Loyalty API
Read CallLoggedOutBalance1
Returns loyalty program structure for non-authenticated users, allowing them to preview the program before signing in.
| Kind | Read API call |
|---|---|
| Method | GET or POST |
| URL | https://app.bubblehouse.com/api/v20230601/<shop>/LoggedOutBalance1 |
| Authentication | AnonymousShop Token |
This method returns the structure and configuration of the loyalty program for users who have not yet authenticated. It's designed to allow stores to render loyalty program details to anonymous visitors.
This call uses the same response structure as CustomerBalance3 but with values representing a logged out user.
Input
-
include_unused_rewardsboolean optionalIf true, the return value will include the
unused_rewardsproperty (with an empty value). -
include_full_programboolean optionalIf true, the return value will include information for rendering an entire loyalty program:
sources,offers,tiers,milestones.Recommended to set this to true when displaying the loyalty program to new visitors to show them all the program benefits.
Output
Global Errors
| Status | Error | Reason & Examples |
|---|---|---|
| 400 | obsolete_global_api_version |
The global API version you are trying to use is no longer supported. |
| 400 | inaccessible_global_api_version |
The global API version you are trying to use is not enabled on your account. |
| 401 | invalid_token |
The provided authentication token is invalid or has expired. |
| 429 | rate_limit_exceeded |
Your usage is over the rate limit. Ensure that you're not making duplicate calls, and contact our team for a rate limit increase. |
| 400 | invalid_global_api_version |
The global API version you are trying to use has never existed. |