# Expiry parameter in tournament record list

**URL:** <https://forum.heroiclabs.com/t/expiry-parameter-in-tournament-record-list/3336>\
**Category:** Documentation\
**Created:** [December 12, 2022, 4:18pm UTC](https://forum.heroiclabs.com/t/expiry-parameter-in-tournament-record-list/3336 "2022-12-12T16:18:31Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![jlisicki-ccgames](https://avatars.discourse-cdn.com/v4/letter/j/7ab992/32.png) [@jlisicki-ccgames](https://forum.heroiclabs.com/u/jlisicki-ccgames)\
**Post date:** [December 12, 2022, 4:18pm UTC](https://forum.heroiclabs.com/t/expiry-parameter-in-tournament-record-list/3336/1 "2022-12-12T16:18:31Z")

</div>

Unity documentation for [ListTournamentRecords](https://dotnet.docs.heroiclabs.com/html/class_nakama_1_1_client.html#aa994ad73bfce3f829e041505fb54e119) describes an `expiry` parameter. But the current description is far from being a complete information why this parameter exists and how to use it. It requires server code inspection to learn that `expire` parameter acts as a pointer to an exact iteration of leaderboard for a given tournament. The value of this “pointer” is inherited from tournament reset and endTime configuration, thus it is not obvious what exactly should be used as value. But you must provide exact value because in database, records are stored under composite key that contains tournament identifier and expires at, so passing the current timestamp or a timestamp in the future as an `expiry` does not work. Since we are not using tournament reset feature we simply put `endActive` value as expiry. It also be valuable to add explanation why and when to use `expiry` field. The surprise was that even if you don’t use the tournament reset function, you won’t be able to display the tournament record after the tournament has ended without providing this field.

---

<div class="post-metadata">

**Author:** ![tom](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.heroiclabs.com/tom/32/676_2.png) [@tom](https://forum.heroiclabs.com/u/tom)\
**Post date:** [December 13, 2022, 9:34am UTC](https://forum.heroiclabs.com/t/expiry-parameter-in-tournament-record-list/3336/2 "2022-12-13T09:34:54Z")

</div>

@jlisicki-ccgames thank you for the feedback, we will look to explain this particular parameter better in our documentation.