# vid-offset

**URL:** <https://community.hubspot.com/t/vid-offset/61117>\
**Category:** APIs & Integrations\
**Tags:** contacts\
**Created:** [July 18, 2022, 7:06am UTC](https://community.hubspot.com/t/vid-offset/61117 "2022-07-18T07:06:07Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![KGaur](https://avatars.discourse-cdn.com/v4/letter/k/a698b9/32.png) [@KGaur](https://community.hubspot.com/u/KGaur)\
**Post date:** [July 18, 2022, 7:06am UTC](https://community.hubspot.com/t/vid-offset/61117/1 "2022-07-18T07:06:07Z")

</div>

Can someone please help me know what is vid-offset with an example ?

Thanks

---

<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:** [July 18, 2022, 8:42pm UTC](https://community.hubspot.com/t/vid-offset/61117/2 "2022-07-18T20:42:12Z")

</div>

@KGaur ,

The vid-offset basically a method of paging that is used on some of our older APIs.

There is a maximum number of records that can be returned at once. Once that limit is met and if there are more, the vid-offset will be included. You will then use this vid-offset as a query param in your subsequent call to return the next set of records. Rinse and repeat until you reach the end.

Pretending you were querying the [list all contacts endpoint](https://legacydocs.hubspot.com/docs/methods/contacts/get_contacts) and that the vid-offset is 2001, you would then construct your second request as such:

`https://api.hubapi.com/contacts/v1/lists/all/contacts/all?vidOffset=2001`