# Query field in v3 search API **URL:** \ **Category:** APIs & Integrations\ **Tags:** contacts\ **Created:** [May 28, 2020, 4:16pm UTC](https://community.hubspot.com/t/query-field-in-v3-search-api/21237 "2020-05-28T16:16:56Z")\ **Posts on this page:** 9\ **Page:** 1
**Author:** ![nstansby](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/nstansby/32/25270_2.png) [@nstansby](https://community.hubspot.com/u/nstansby)\ **Post date:** [May 28, 2020, 4:16pm UTC](https://community.hubspot.com/t/query-field-in-v3-search-api/21237/1 "2020-05-28T16:16:56Z")
I am trying to use the v3 search API (/crm/v3/objects/contacts/search). I’ve been struggling to understand the **query** field… I haven’t been able to find any documentation on it, or examples. It seems the combination of the **properties** and **filterGroups** fields in the request specifiy what records you want, and what properties you want to retrieve, so what is the purpose of the **query** field? And can anyone point me at an example of how to use it? I’m new to HubSpot and decided to dive directly into the v3 API; maybe this is a concept carried over from earlier versions of the API? ---
**Author:** ![WendyGoh](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/wendygoh/32/42320_2.png) [@WendyGoh](https://community.hubspot.com/u/WendyGoh)\ **Post date:** [May 29, 2020, 7:12am UTC](https://community.hubspot.com/t/query-field-in-v3-search-api/21237/2 "2020-05-29T07:12:45Z")
Hey @nstansby, Welcome to HubSpot 🙂 The query will search based on the **default searchable properties** (_mentioned on this documentation:_ [_CRM API | Search_](https://developers.hubspot.com/docs/api/crm/search)) i.e. for contacts, it would be firstname, hs\_additional\_emails, phone, hs\_object\_id, hs\_searchable\_calculated\_phone\_number, company, email and lastname. ---
**Author:** ![nstansby](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/nstansby/32/25270_2.png) [@nstansby](https://community.hubspot.com/u/nstansby)\ **Post date:** [May 29, 2020, 2:18pm UTC](https://community.hubspot.com/t/query-field-in-v3-search-api/21237/3 "2020-05-29T14:18:09Z")
Thanks @WendyGoh , I’d just been looking at the endpoint documentation. The link you sent is exactly what I needed. ---
**Author:** ![kawyns1](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/kawyns1/32/27089_2.png) [@kawyns1](https://community.hubspot.com/u/kawyns1)\ **Post date:** [October 9, 2020, 12:48pm UTC](https://community.hubspot.com/t/query-field-in-v3-search-api/21237/4 "2020-10-09T12:48:40Z")
Hi @WendyGoh , I have a similar use case where i want to filter by the lastmodifieddate property to get the tickets records since the last timestamp. Is it possible to get this data from the search crm api? ---
**Author:** ![christran](https://avatars.discourse-cdn.com/v4/letter/c/e79b87/32.png) [@christran](https://community.hubspot.com/u/christran)\ **Post date:** [April 3, 2025, 4:22am UTC](https://community.hubspot.com/t/query-field-in-v3-search-api/21237/5 "2025-04-03T04:22:56Z")
Man, this document is crazy. That thing should be documented in below section instead of letting developers struggle to search for answer in Google. > **[Accounts Dashboard | HubSpot](https://app.hubspot.com/myaccounts?next=developerdocs&redirect=%2Fapi-reference%2Fcrm-emails-v3%2Fguide)** ---
**Author:** ![WendyGoh](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/wendygoh/32/42320_2.png) [@WendyGoh](https://community.hubspot.com/u/WendyGoh)\ **Post date:** [October 12, 2020, 8:21am UTC](https://community.hubspot.com/t/query-field-in-v3-search-api/21237/6 "2020-10-12T08:21:51Z")
Hey @kawyns1, This is possible via the HubSpot [CRM API | Search](https://developers.hubspot.com/docs/api/crm/search). You can do something like this: ```lia-code-sample curl https://api.hubapi.com/crm/v3/objects/contacts/search?hapikey=YOUR_HUBSPOT_API_KEY \ --request POST \ --header "Content-Type: application/json" \ --data '{ "filterGroups":[ { "filters":[ { "propertyName": "lastmodifieddate", "operator": "EQ", "value": "{{timestamp here}}" } ] } ] } ``` ---
**Author:** ![Spark-Y](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/spark-y/32/68963_2.png) [@Spark-Y](https://community.hubspot.com/u/Spark-Y)\ **Post date:** [July 16, 2021, 11:28am UTC](https://community.hubspot.com/t/query-field-in-v3-search-api/21237/7 "2021-07-16T11:28:56Z")
Can anyone give some examples for the PHP in curl ? ---
**Author:** ![Long\_Nguyen](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/long_nguyen/32/77060_2.png) [@Long\_Nguyen](https://community.hubspot.com/u/Long_Nguyen)\ **Post date:** [November 26, 2021, 8:44am UTC](https://community.hubspot.com/t/query-field-in-v3-search-api/21237/8 "2021-11-26T08:44:25Z")
Hi @WendyGoh Is this API available via URL in the browser? Can you please give me an example of URL rather than curl? For example, with API version 1, in order to list all contacts with specific properties I can paste in the browser with the following URL. [https://api.hubapi.com/contacts/v1/lists/all/contacts/all?hapikey=YOUR\_HUBSPOT\_API\_KEY&count=15&&propertyMode=value\_and\_history&property=YOURPROPERTIES](https://api.hubapi.com/contacts/v1/lists/all/contacts/all?hapikey=YOUR_HUBSPOT_API_KEY&count=15&&propertyMode=value_and_history&property=YOURPROPERTIES) ![Snipaste_2021-11-26_15-40-59.png](https://d2qpr2jzcazej7.cloudfront.net/original/2X/7/7ec37eee9128de1f980a6f9adfcf6fe3aca810e2.png) ---
**Author:** ![BEAutoBot](https://avatars.discourse-cdn.com/v4/letter/b/ba9def/32.png) [@BEAutoBot](https://community.hubspot.com/u/BEAutoBot)\ **Post date:** [March 10, 2023, 9:19pm UTC](https://community.hubspot.com/t/query-field-in-v3-search-api/21237/9 "2023-03-10T21:19:55Z")
This is the correct answer and contains the important structure of the neccessary query object. Thank you.