# Contacts Lists API - Only Legacy ?

**URL:** <https://community.hubspot.com/t/contacts-lists-api-only-legacy/30451>\
**Category:** APIs & Integrations\
**Tags:** timeline-and-extensions-apis\
**Created:** [January 19, 2021, 11:27pm UTC](https://community.hubspot.com/t/contacts-lists-api-only-legacy/30451 "2021-01-19T23:27:01Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![jdlm](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/jdlm/32/30191_2.png) [@jdlm](https://community.hubspot.com/u/jdlm)\
**Post date:** [January 19, 2021, 11:27pm UTC](https://community.hubspot.com/t/contacts-lists-api-only-legacy/30451/1 "2021-01-19T23:27:01Z")

</div>

Hi,

is there a v3 equivalent of the GET /contacts/v1/lists/ endpoint to be able to retrieve ALL lists for a user?

[https://legacydocs.hubspot.com/docs/methods/lists/get\_lists](https://legacydocs.hubspot.com/docs/methods/lists/get_lists)

If not, will v1 remain supported ? I’m thinking about starting to migrate our integration to use v3 but cannot do so if I can’t get lists.

Many thanks

Julien

---

<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:** [January 20, 2021, 9:06pm UTC](https://community.hubspot.com/t/contacts-lists-api-only-legacy/30451/2 "2021-01-20T21:06:32Z")

</div>

Hello @jdlm

V1 is the most up to date. V3 is in developmemt.

We will provide ample notification if an endpoint is going to be sunset. Check out more info on breaking changes [here](https://developers.hubspot.com/docs/breaking-change-definition)

I also recommend subscribing to the [Developer Announcements board](https://community.hubspot.com/t5/Developer-Announcements/What-to-expect-in-the-Developer-Announcements/m-p/381649) where we will notify of anything changing.

Happy coding!