# Subscription list Timeline

**URL:** <https://community.hubspot.com/t/subscription-list-timeline/31687>\
**Category:** APIs & Integrations\
**Tags:** professional\
**Created:** [February 12, 2021, 12:36am UTC](https://community.hubspot.com/t/subscription-list-timeline/31687 "2021-02-12T00:36:41Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![MShams](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/mshams/32/2490_2.png) [@MShams](https://community.hubspot.com/u/MShams)\
**Post date:** [February 12, 2021, 12:36am UTC](https://community.hubspot.com/t/subscription-list-timeline/31687/1 "2021-02-12T00:36:41Z")

</div>

I am trying to get the current subscription list to make a list of users who want to unsubscribe. The demo API is the one below:

[https://api.hubapi.com/email/public/v1/subscriptions/timeline?hapikey=demo](https://api.hubapi.com/email/public/v1/subscriptions/timeline?hapikey=demo)

However, I could not make sure up to which time ago it lists the items. Say, if I hit the link at 17:00 hours, then up to what time back this list is being populated.

Then again, if I hit the link at 23:00 hours, will it give me a list for a different time-span? Is it like per day? Is there any other parameter to tweak the time span? Is it relative to different time zones, e..g: GMT, AEST etc.?

Thank you in advance.

---

<div class="post-metadata">

**Author:** ![dennisedson](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/dennisedson/32/28044_2.png) [@dennisedson](https://community.hubspot.com/u/dennisedson)\
**Post date:** [February 12, 2021, 7:55pm UTC](https://community.hubspot.com/t/subscription-list-timeline/31687/2 "2021-02-12T19:55:50Z")

</div>

Hi @MShams

You will want to use the **startTimestamp=X** and the **endTimestamp=X** parameters in your call. You can see a full list [here](https://legacydocs.hubspot.com/docs/methods/email/get_subscriptions_timeline).

The time needs to be set using a Unix timestamp in milliseconds. [Unix timestamps](https://en.wikipedia.org/wiki/Unix_time) are time zone independent so do not worry about that part.

---

<div class="post-metadata">

**Author:** ![MShams](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/mshams/32/2490_2.png) [@MShams](https://community.hubspot.com/u/MShams)\
**Post date:** [February 14, 2021, 11:33pm UTC](https://community.hubspot.com/t/subscription-list-timeline/31687/3 "2021-02-14T23:33:15Z")

</div>

Thank you Dennisedson,

I tried to add the parameters and make the call. In response it said it expects an offset from the previous call. Then I called again without any parameters but only the api key ‘demo’. It returned an offset at this time. Then I added the offset to the actual call with other parameters and it returned the inteded list.

The question is, is it the right way (getting offset value without other parameters, then adding that parameter with the actual call) to obtain the subscription list for a given timespan? It looks like the first call without any parameters obtains a key (offset), which is to add to the second call so that it opens the door of the subscription list for a given timespan. Is that the way it is, or am I making any mistake?

Best regards,

Mehedi

---

<div class="post-metadata">

**Author:** ![dennisedson](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/dennisedson/32/28044_2.png) [@dennisedson](https://community.hubspot.com/u/dennisedson)\
**Post date:** [February 17, 2021, 3:26pm UTC](https://community.hubspot.com/t/subscription-list-timeline/31687/4 "2021-02-17T15:26:45Z")

</div>

@MShams ,

Looks like you got it 👍