# API endpoint to retrieve Custom Properties Usages

**URL:** <https://community.hubspot.com/t/api-endpoint-to-retrieve-custom-properties-usages/86355>\
**Category:** APIs & Integrations\
**Tags:** professional\
**Created:** [July 28, 2023, 12:45pm UTC](https://community.hubspot.com/t/api-endpoint-to-retrieve-custom-properties-usages/86355 "2023-07-28T12:45:05Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![alvarofranz](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/alvarofranz/32/63428_2.png) [@alvarofranz](https://community.hubspot.com/u/alvarofranz)\
**Post date:** [July 28, 2023, 12:45pm UTC](https://community.hubspot.com/t/api-endpoint-to-retrieve-custom-properties-usages/86355/1 "2023-07-28T12:45:05Z")

</div>

When performing a manual export via the HubSpot Web UI, the exported files with all properties, contains information about the usage of those properties:

A property such as Job Title might be used in an Active List to get a full list of Contacts with “marketing” in their title. So that would appear in HubSpot as “used in” showing a link to that list. The export would only show a count of (1) Lists in that column. Properties may also be used in Forms, Reports, Workflows, etc.

But when using the Properties API endpoint, I don’t get said information.

**Question** : is there any way to get the information about Usages for a Custom property via the API?

Thanks!

---

<div class="post-metadata">

**Author:** ![BhupendraKumar](https://avatars.discourse-cdn.com/v4/letter/b/a587f6/32.png) [@BhupendraKumar](https://community.hubspot.com/u/BhupendraKumar)\
**Post date:** [July 29, 2023, 8:05am UTC](https://community.hubspot.com/t/api-endpoint-to-retrieve-custom-properties-usages/86355/2 "2023-07-29T08:05:53Z")

</div>

hi @alva ,

I you want to get the custom fields also you can get them in the api response by inclduing them as query parameter like this

For Example you have custom property job\_title in deal then it will be like

`_properties=job\_title_` properties.

_i.e. crm/v3/objects/deals?properties=job\_title&limit=100&properties=dealstage_

---

<div class="post-metadata">

**Author:** ![alvarofranz](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/alvarofranz/32/63428_2.png) [@alvarofranz](https://community.hubspot.com/u/alvarofranz)\
**Post date:** [July 29, 2023, 8:09am UTC](https://community.hubspot.com/t/api-endpoint-to-retrieve-custom-properties-usages/86355/3 "2023-07-29T08:09:29Z")

</div>

Thanks but this is not what I mean. I mean the Usages: A property such as Job Title might be used in an Active List to get a full list of Contacts with “marketing” in their title. So that would appear in HubSpot as “used in” showing a link to that list. The export would only show a count of (1) Lists in that column. Properties may also be used in Forms, Reports, Workflows, etc.

---

<div class="post-metadata">

**Author:** ![BhupendraKumar](https://avatars.discourse-cdn.com/v4/letter/b/a587f6/32.png) [@BhupendraKumar](https://community.hubspot.com/u/BhupendraKumar)\
**Post date:** [July 29, 2023, 8:12am UTC](https://community.hubspot.com/t/api-endpoint-to-retrieve-custom-properties-usages/86355/4 "2023-07-29T08:12:15Z")

</div>

@alvarofranz

There was no direct API endpoint in the HubSpot API to retrieve the “Usages” information for a specific property. The HubSpot API primarily focused on CRUD (Create, Read, Update, Delete) operations for objects like Contacts, Companies, Deals, etc., and did not expose endpoints to access internal configuration or metadata information, such as property usages.

---

<div class="post-metadata">

**Author:** ![alvarofranz](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/alvarofranz/32/63428_2.png) [@alvarofranz](https://community.hubspot.com/u/alvarofranz)\
**Post date:** [July 29, 2023, 3:24pm UTC](https://community.hubspot.com/t/api-endpoint-to-retrieve-custom-properties-usages/86355/5 "2023-07-29T15:24:15Z")

</div>

So instead of so many words, the answer is more simple:

**“It’s not possible”.**

Right? Thanks!

---

<div class="post-metadata">

**Author:** ![BhupendraKumar](https://avatars.discourse-cdn.com/v4/letter/b/a587f6/32.png) [@BhupendraKumar](https://community.hubspot.com/u/BhupendraKumar)\
**Post date:** [July 29, 2023, 3:37pm UTC](https://community.hubspot.com/t/api-endpoint-to-retrieve-custom-properties-usages/86355/6 "2023-07-29T15:37:29Z")

</div>

Yes