# How to use search API for Users

**URL:** <https://community.hubspot.com/t/how-to-use-search-api-for-users/106685>\
**Category:** APIs & Integrations\
**Tags:** developer-tools\
**Created:** [May 8, 2024, 6:44am UTC](https://community.hubspot.com/t/how-to-use-search-api-for-users/106685 "2024-05-08T06:44:04Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![Egoi](https://avatars.discourse-cdn.com/v4/letter/e/71c47a/32.png) [@Egoi](https://community.hubspot.com/u/Egoi)\
**Post date:** [May 8, 2024, 6:44am UTC](https://community.hubspot.com/t/how-to-use-search-api-for-users/106685/1 "2024-05-08T06:44:04Z")

</div>

I´m trying to find the way to properly use the [Users API](https://developers.hubspot.com/docs/api/crm/users). I have already used search endpoints on objects without any problem, but cannot make it work for Users.  
The endpoint is this: /crm/v3/objects/users/search  
And the body I am using as an example is this:

```lia-code-sample
{
 "filters": [
 {
 "propertyName": "firstname",
 "operator": "EQ",
 "value": "Eg"
 }
 ]
}

```

But does not work:

```lia-code-sample
{
	"status": "error",
	"message": "There was a problem with the request.",
	"correlationId": "d16119b2-8ee8-4035-888f-b630a52362af"
}

```

Any advice?  
Thank you!

---

<div class="post-metadata">

**Author:** ![GRajput](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/grajput/32/102020_2.png) [@GRajput](https://community.hubspot.com/u/GRajput)\
**Post date:** [May 8, 2024, 9:26am UTC](https://community.hubspot.com/t/how-to-use-search-api-for-users/106685/2 "2024-05-08T09:26:22Z")

</div>

Hi @Egoi

Please use the following json:

```lia-code-sample
{
 "properties": [
 "hs_given_name","hs_family_name","hs_email"
 ],
 "filterGroups": [
 {
 "filters": [
 {
 "propertyName": "hs_given_name",
 "value": "Eg",
 "operator": "EQ"
 }
 ]
 }
 ]
}

```

Here hs\_given\_name is an api name for user’s firstname.  
hs\_family\_name is an api name for user’s lastname.  
hs\_email is an api name for user’s email address.

I hope this will help you out. Please mark it as **Solution Accepted and upvote** to help another Community member.  
Thanks!

---

<div class="post-metadata">

**Author:** ![danielthomas23](https://avatars.discourse-cdn.com/v4/letter/d/85f322/32.png) [@danielthomas23](https://community.hubspot.com/u/danielthomas23)\
**Post date:** [June 28, 2024, 1:50am UTC](https://community.hubspot.com/t/how-to-use-search-api-for-users/106685/3 "2024-06-28T01:50:07Z")

</div>

Thank you Gaurav, this was helpful for me to understand what hubspot calls the property names. I knew email and title from the API endpoints within the documentation, but no mention of how to get the name. As user isnt listed as an object in settings we cant search through there either.

I’m curious if there is documnetation anywhere that lists all the properties related to user

---

<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:** [May 9, 2024, 8:32pm UTC](https://community.hubspot.com/t/how-to-use-search-api-for-users/106685/4 "2024-05-09T20:32:18Z")

</div>

Hey, @Egoi You can make a request to the Properties API to all the available properties and their internal values:

```lia-code-sample
curl --request GET \
 --url 'https://api.hubapi.com/crm/v3/properties/users?archived=false' \
 --header 'authorization: Bearer YOUR_ACCESS_TOKEN'

```

Best,

Jaycee