# Question About Deprecated definition Field in LoyaltyProgramRewardTier

**URL:** <https://developer.squareup.com/forums/t/question-about-deprecated-definition-field-in-loyaltyprogramrewardtier/22671>\
**Category:** Questions\
**Tags:** loyalty-api\
**Created:** [June 6, 2025, 7:06am UTC](https://developer.squareup.com/forums/t/question-about-deprecated-definition-field-in-loyaltyprogramrewardtier/22671 "2025-06-06T07:06:12Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![murphyzhang](https://avatars.discourse-cdn.com/v4/letter/m/fbc32d/32.png) [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\
**Post date:** [June 6, 2025, 7:06am UTC](https://developer.squareup.com/forums/t/question-about-deprecated-definition-field-in-loyaltyprogramrewardtier/22671/1 "2025-06-06T07:06:12Z")

</div>

Hi Square Team,

I noticed that the `definition` field in the `LoyaltyProgramRewardTier` object has been marked as deprecated in the API documentation. However, I’m still able to retrieve this field when querying the API.

> **[GET /v2/loyalty/programs/{program\_id} - Square API Reference](https://developer.squareup.com/reference/square/loyalty-api/retrieve-loyalty-program)**
>
> Retrieves the loyalty program in a seller's account, specified by the program ID or the keyword \`main\`.

 ![image](https://global.discourse-cdn.com/square/original/2X/6/6b2b5f0d46537339aa667180578655b081fcd2db.png)  
 ![image](https://global.discourse-cdn.com/square/original/2X/1/12c17bda5c7e45dd0908220cc3f842373a8877f6.png)

Could you please clarify when this field is expected to be fully removed from the API response?  
We want to ensure our integration is prepared ahead of time.

Thank you for your support!

Best regards,  
Murphy

---

<div class="post-metadata">

**Author:** ![Square-Dev-AI](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/square-dev-ai/32/2513_2.png) [@Square-Dev-AI](https://developer.squareup.com/forums/u/Square-Dev-AI)\
**Post date:** [June 6, 2025, 7:06am UTC](https://developer.squareup.com/forums/t/question-about-deprecated-definition-field-in-loyaltyprogramrewardtier/22671/2 "2025-06-06T07:06:27Z")

</div>

👋 I’m Square Dev AI, here to help answer your question!  
Based on the information you’ve provided, the following documentation will help answer your question:

> **[Deprecated Items](https://developer.squareup.com/docs/migrate-from-v1/current-status)**
>
> Learn about the current status of deprecated Square APIs.

> **[Loyalty API](https://developer.squareup.com/docs/loyalty-api/overview)**
>
> Learn about the Loyalty API and how to set up a loyalty program, enroll buyers in the program, accrue points, and redeem points.

> **Additional Documentation**
>
> [Retrieve Loyalty Program](https://developer.squareup.com/docs/loyalty-api/loyalty-programs)  
> [Loyalty Program](https://developer.squareup.com/docs/loyalty/overview)  
> [Manage Loyalty Rewards](https://developer.squareup.com/docs/loyalty-api/loyalty-rewards)

If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.  
Otherwise one of our Developer Advocates will provide additional assistance shortly.

---

<div class="post-metadata">

**Author:** ![Square-Dev-AI](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/square-dev-ai/32/2513_2.png) [@Square-Dev-AI](https://developer.squareup.com/forums/u/Square-Dev-AI)\
**Post date:** [June 6, 2025, 4:11pm UTC](https://developer.squareup.com/forums/t/question-about-deprecated-definition-field-in-loyaltyprogramrewardtier/22671/3 "2025-06-06T16:11:35Z")

</div>

The `definition` field in the `LoyaltyProgramRewardTier` object is indeed marked as deprecated, but it’s not yet retired. Deprecated fields are typically removed when the item is retired in a future Square API version. However, the exact retirement date for this field hasn’t been specified yet.

In the meantime, you should start migrating to use the `pricing_rule_reference` field, which is the replacement for the deprecated `definition` field. This will ensure your integration remains functional when the `definition` field is eventually retired.

_This answer was reviewed by @Bryan-Square._