# Get Recent Contacts Issue

**URL:** <https://community.hubspot.com/t/get-recent-contacts-issue/14425>\
**Category:** APIs & Integrations\
**Tags:** contacts\
**Created:** [May 17, 2019, 2:27pm UTC](https://community.hubspot.com/t/get-recent-contacts-issue/14425 "2019-05-17T14:27:54Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![gmites](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/gmites/32/9140_2.png) [@gmites](https://community.hubspot.com/u/gmites)\
**Post date:** [May 17, 2019, 2:27pm UTC](https://community.hubspot.com/t/get-recent-contacts-issue/14425/1 "2019-05-17T14:27:54Z")

</div>

Hello!

I’m testing the service [Get Recent Contacts.](https://developers.hubspot.com/docs/methods/contacts/get_recently_created_contacts)  
[https://api.hubapi.com/contacts/v1/lists/all/contacts/recent?hapikey=demo&timeOffset=1558087200](https://api.hubapi.com/contacts/v1/lists/all/contacts/recent?hapikey=demo&timeOffset=1558087200)  
I’m expecting it to return a list of contacts created since a specific time by passing timeOffset=X. However, I’m getting a list of contacts.  
I would like to know since what date of creation this service returns the list of contacts?  
Which is the criterion to return that list of contacts?  
Could you please help me?  
Thanks!

---

<div class="post-metadata">

**Author:** ![IsaacTakushi](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/isaactakushi/32/70387_2.png) [@IsaacTakushi](https://community.hubspot.com/u/IsaacTakushi)\
**Post date:** [May 20, 2019, 2:21pm UTC](https://community.hubspot.com/t/get-recent-contacts-issue/14425/2 "2019-05-20T14:21:31Z")

</div>

Hi, @gmites.

Happy to clarify!

The [_Get recently created contacts_](https://developers.hubspot.com/docs/methods/contacts/get_recently_created_contacts) endpoint returns created contacts in _reverse chronological_ order. Per the documentation: **"The response is sorted in descending order by _Create date_**** ; the most recently created contact is returned first."**

The `timeOffset` parameter is used with the `vidOffset` parameter to page back in time through created contacts. It does _not_ serve as a time filter, however, as it must be combined with the `vidOffset` parameter.

For example, if you query `/contacts/v1/lists/all/contacts/recent?count=100`, you will get the 100 most recently created contacts. If you use the `time-offset` value at the end of the response _without_ also using the `vid-offset` value (e.g. `/contacts/v1/lists/all/contacts/recent?count=100&timeOffset=1552666574201`), you will receive the same list of 100 contacts. To get the _next_ 100 contacts, you must use both parameters: `/contacts/v1/lists/all/contacts/recent?count=100&timeOffset=1552666574201&vidOffset=149851`.