# Loyalty API Released in Beta

**URL:** <https://developer.squareup.com/forums/t/loyalty-api-released-in-beta/321>\
**Category:** Announcements\
**Tags:** loyalty-api\
**Created:** [May 29, 2020, 5:21pm UTC](https://developer.squareup.com/forums/t/loyalty-api-released-in-beta/321 "2020-05-29T17:21:54Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![wootmoot](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/wootmoot/32/21_2.png) [@wootmoot](https://developer.squareup.com/forums/u/wootmoot)\
**Post date:** [May 29, 2020, 5:21pm UTC](https://developer.squareup.com/forums/t/loyalty-api-released-in-beta/321/1 "2020-05-29T17:21:54Z")

</div>

We’re excited to announce the brand new Loyalty API in beta! For the first time ever, you can extend Square Loyalty outside of Square to third-party online and mobile channels. Now, sellers can expand their Loyalty program to wherever their buyers shop, whether it’s an order-ahead app or an eCommerce site. With Loyalty API, developers can enroll customers in loyalty programs, view details of loyalty accounts, accrue and redeem loyalty points, and more. Check out the [documentation](https://developer.squareup.com/docs/loyalty/overview) to get started. Feel free to ask questions or provide feedback here!

---

<div class="post-metadata">

**Author:** ![wootmoot](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/wootmoot/32/21_2.png) [@wootmoot](https://developer.squareup.com/forums/u/wootmoot)\
**Post date:** [May 29, 2020, 5:23pm UTC](https://developer.squareup.com/forums/t/loyalty-api-released-in-beta/321/2 "2020-05-29T17:23:42Z")

</div>

Pinned globally on May 29, 2020, 5:23pm UTC



---

<div class="post-metadata">

**Author:** ![JeffBall](https://avatars.discourse-cdn.com/v4/letter/j/f6c823/32.png) [@JeffBall](https://developer.squareup.com/forums/u/JeffBall)\
**Post date:** [May 31, 2020, 9:59pm UTC](https://developer.squareup.com/forums/t/loyalty-api-released-in-beta/321/3 "2020-05-31T21:59:38Z")

</div>

🙌 🙌 🙌 YES!! Great news!

---

<div class="post-metadata">

**Author:** ![TFD\_DJ](https://avatars.discourse-cdn.com/v4/letter/t/dfb087/32.png) [@TFD\_DJ](https://developer.squareup.com/forums/u/TFD_DJ)\
**Post date:** [June 10, 2020, 5:53am UTC](https://developer.squareup.com/forums/t/loyalty-api-released-in-beta/321/4 "2020-06-10T05:53:47Z")

</div>

Will there be a way to test the loyalty in a sandbox mode without signing up for a 30 day trial or paid monthly?

---

<div class="post-metadata">

**Author:** ![wootmoot](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/wootmoot/32/21_2.png) [@wootmoot](https://developer.squareup.com/forums/u/wootmoot)\
**Post date:** [June 10, 2020, 4:11pm UTC](https://developer.squareup.com/forums/t/loyalty-api-released-in-beta/321/5 "2020-06-10T16:11:58Z")

</div>

Yes, you have access to the Loyalty program in the Sandbox test account, without needing to sign up for the 30 day trial or paid loyalty program. So you should be able to build your loyalty integration using Sandbox.

---

<div class="post-metadata">

**Author:** ![fusionbrew](https://avatars.discourse-cdn.com/v4/letter/f/e99b99/32.png) [@fusionbrew](https://developer.squareup.com/forums/u/fusionbrew)\
**Post date:** [June 11, 2020, 2:32am UTC](https://developer.squareup.com/forums/t/loyalty-api-released-in-beta/321/6 "2020-06-11T02:32:33Z")

</div>

Is there any way to access the Loyalty Coupons that are on a Customer account? In the past when a Loyalty Reward was not used during the completion of a sale the Reward would be “converted” to a Coupon on the customer’s account. I have been doing some experimenting with the new Loyalty API but I can’t find any way to list of manage those coupons.

---

<div class="post-metadata">

**Author:** ![wootmoot](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/wootmoot/32/21_2.png) [@wootmoot](https://developer.squareup.com/forums/u/wootmoot)\
**Post date:** [June 15, 2020, 7:26pm UTC](https://developer.squareup.com/forums/t/loyalty-api-released-in-beta/321/7 "2020-06-15T19:26:27Z")

</div>

You can see all of the capabilities of the Loyalty API in the technical references ([https://developer.squareup.com/reference/square/loyalty-api](https://developer.squareup.com/reference/square/loyalty-api)), but looking up a loyalty reward (I think that is what we have that is most similar to the coupon), can be done using the Search Loyalty Rewards endpoint ([https://developer.squareup.com/reference/square/loyalty-api/search-loyalty-rewards](https://developer.squareup.com/reference/square/loyalty-api/search-loyalty-rewards)).

You can always check out our guides as well, for some help in building your integration:

> **[Loyalty Program](https://developer.squareup.com/docs/loyalty/overview)**
>
> Learn about Square Loyalty program and Loyalty API.

---

<div class="post-metadata">

**Author:** ![fusionbrew](https://avatars.discourse-cdn.com/v4/letter/f/e99b99/32.png) [@fusionbrew](https://developer.squareup.com/forums/u/fusionbrew)\
**Post date:** [June 16, 2020, 3:15pm UTC](https://developer.squareup.com/forums/t/loyalty-api-released-in-beta/321/8 "2020-06-16T15:15:34Z")

</div>

If I execute the “searchLoyaltyRewards” with an empty search criteria the call is supposed to return all rewards. When I make this call I get an empty results. I know that I have customers with “coupons” on their account:  
 ![Annotation 2020-06-16 101407](https://global.discourse-cdn.com/square/original/1X/aaf7d8ae920dfe0368a6ac1ed798bc0831592d23.jpeg)

---

<div class="post-metadata">

**Author:** ![yushan](https://avatars.discourse-cdn.com/v4/letter/y/f14d63/32.png) [@yushan](https://developer.squareup.com/forums/u/yushan)\
**Post date:** [June 16, 2020, 6:33pm UTC](https://developer.squareup.com/forums/t/loyalty-api-released-in-beta/321/9 "2020-06-16T18:33:47Z")

</div>

Only rewards created via the API will be returned by the searchLoyaltyRewards endpoint.

These “Coupons” created via the POS reward redemption are an intermediate solution that will eventually be phased out.

Rewards created via the API should be deleted if unused so that the point balance can be returned.

---

<div class="post-metadata">

**Author:** ![Veronica](https://avatars.discourse-cdn.com/v4/letter/v/6a8cbe/32.png) [@Veronica](https://developer.squareup.com/forums/u/Veronica)\
**Post date:** [September 20, 2021, 12:51pm UTC](https://developer.squareup.com/forums/t/loyalty-api-released-in-beta/321/10 "2021-09-20T12:51:34Z")

</div>

Thanks for update and quick reply. I’ll be sure to keep an eye on this thread. Looking for the same info.

[alaskasworld](https://alaskasworld.run/)
