# Lists API

**URL:** <https://community.hubspot.com/t/lists-api/139362>\
**Category:** APIs & Integrations\
**Tags:** professional\
**Created:** [September 11, 2025, 9:19am UTC](https://community.hubspot.com/t/lists-api/139362 "2025-09-11T09:19:17Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![05629](https://avatars.discourse-cdn.com/v4/letter/0/34f0e0/32.png) [@05629](https://community.hubspot.com/u/05629)\
**Post date:** [September 11, 2025, 9:19am UTC](https://community.hubspot.com/t/lists-api/139362/1 "2025-09-11T09:19:17Z")

</div>

Hello.

According to the API documentation, we need to provide an additionalProperties array with property names to get their values in the response.

But where can we get the list of all available properties for the list?

---

<div class="post-metadata">

**Author:** ![BrandonWoodruff](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/brandonwoodruff/32/61045_2.png) [@BrandonWoodruff](https://community.hubspot.com/u/BrandonWoodruff)\
**Post date:** [September 11, 2025, 1:24pm UTC](https://community.hubspot.com/t/lists-api/139362/2 "2025-09-11T13:24:19Z")

</div>

Hello,

According to the [Lists API Documentation,](https://developers.hubspot.com/docs/api-reference/crm-lists-v3/lists/post-crm-v3-lists-search)it will default return the following properties:  
hs\_list\_size, hs\_last\_record\_added\_at, hs\_last\_record\_removed\_at, hs\_folder\_name, and hs\_list\_reference\_count.

For any other properties that you may want to add, you can check what list properties you have set up by going to your settings \>\> Data Management \>\> Properties, and then select the List Object.

Let me know if this helps, or if you have any other questions!

* * *

✔ Was I able to help answer your question? Help the community by **marking it as a solution.**

| ![](https://d2qpr2jzcazej7.cloudfront.net/original/3X/d/3/d314478a36473977ed45320812b9331d25e0d3c4.jpeg) | **[Brandon Woodruff](https://www.linkedin.com/in/brandon-woody-woodruff/)**  
Senior Software Developer @ [Pearagon](https://www.pearagon.com/)Still have questions? Reach out at [brandon@pearagon.com](mailto:brandon@pearagon.com) ![](https://d2qpr2jzcazej7.cloudfront.net/original/3X/8/2/82ba9e282e49f5082144dc270d5741cca176f2cb.png) |

* * *

---

<div class="post-metadata">

**Author:** ![Jaycee\_Lewis](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/jaycee_lewis/32/61352_2.png) [@Jaycee\_Lewis](https://community.hubspot.com/u/Jaycee_Lewis)\
**Post date:** [September 11, 2025, 8:04pm UTC](https://community.hubspot.com/t/lists-api/139362/3 "2025-09-11T20:04:23Z")

</div>

Hey, @05629 can you link me to the specific doc you are working with, please? I want to make sure that I am looking at the same info you are. Thank you! — Jaycee

---

<div class="post-metadata">

**Author:** ![mohdisrarmwb](https://avatars.discourse-cdn.com/v4/letter/m/b3f665/32.png) [@mohdisrarmwb](https://community.hubspot.com/u/mohdisrarmwb)\
**Post date:** [September 12, 2025, 12:34pm UTC](https://community.hubspot.com/t/lists-api/139362/4 "2025-09-12T12:34:28Z")

</div>

Hi @05629,

This is the endpoint to [retrieve all properties](https://developers.hubspot.com/docs/api-reference/crm-properties-v3/core/get-crm-v3-properties-objectType). However, if you pass “lists” in {objectType} (as you would for contacts or companies), You won’t be able to retrieve the list of properties.

I found a workaround and wanted to share it with you: instead of passing “lists” in {objectType}, pass the “lists” object ID (0-45) — and you’ll see the magic happen.

Best regards,  
Mohd Israr

---

<div class="post-metadata">

**Author:** ![05629](https://avatars.discourse-cdn.com/v4/letter/0/34f0e0/32.png) [@05629](https://community.hubspot.com/u/05629)\
**Post date:** [September 14, 2025, 12:12pm UTC](https://community.hubspot.com/t/lists-api/139362/5 "2025-09-14T12:12:52Z")

</div>

Thanks a lot! That works.  
I also tried this, but wasn’t able to find an object ID for the list. Is it in the docs?Can you share a link, please?

---

<div class="post-metadata">

**Author:** ![mohdisrarmwb](https://avatars.discourse-cdn.com/v4/letter/m/b3f665/32.png) [@mohdisrarmwb](https://community.hubspot.com/u/mohdisrarmwb)\
**Post date:** [September 15, 2025, 4:50am UTC](https://community.hubspot.com/t/lists-api/139362/6 "2025-09-15T04:50:15Z")

</div>

No, this is not mentioned in the docs. These are my own findings