{"id":6251,"date":"2024-08-27T15:58:11","date_gmt":"2024-08-27T22:58:11","guid":{"rendered":"https:\/\/support.gwapps.com\/?post_type=ht_kb&#038;p=6251"},"modified":"2024-08-27T15:58:12","modified_gmt":"2024-08-27T22:58:12","slug":"search-records","status":"publish","type":"ht_kb","link":"https:\/\/support.gwapps.com\/es\/knowledge-base\/search-records\/","title":{"rendered":"Search Records"},"content":{"rendered":"\n<p>API endpoint that will return a list of records that match the given criteria.<\/p>\n\n\n\n<p>Note: This API documentation is intended to give the reader an overview of the APIs capabilities and how to access them. When trying to write API calls, we strongly recommend you use the API documentation directly associated with the specific API key you will be calling. That documentation includes examples with the actual IDs of the form and form elements, includes examples for each field available in the associated forms etc. This will allow direct copy-paste of the code snippets from the documentation into your code. If you were to try and use the examples in this documentation, you would have to modify them for the fields, form ID, etc.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">HTTP request<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">POST https:\/\/api.gwapps.com\/v1\/forms\/<em>formId<\/em>\/records\/search<\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">Parameters<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Parameter<\/th><th>Description<\/th><th>Type<\/th><th>Default<\/th><\/tr><\/thead><tbody><tr><td colspan=\"3\">Optional query parameters<\/td><\/tr><tr><td>fields<\/td><td>Comma separated list of fields (See the&nbsp;<strong>Overview<\/strong>&nbsp;section to get the list of available fields)<\/td><td>string<\/td><td><\/td><\/tr><tr><td>maxResult<\/td><td>Maximum number of entries returned in one result page. By default the value is set to&nbsp;<strong>100<\/strong>. Valid range is 1 &#8211; 200.<\/td><td>number<\/td><td>100<\/td><\/tr><tr><td>pageNumber<\/td><td>The page number, the response will return the flag&nbsp;<code>hasNext<\/code>&nbsp;that can be used to check if there are more pages and increment the pageNumber until there are no more pages to return.<\/td><td>number<\/td><td>1<\/td><\/tr><tr><td>orderBy<\/td><td>A field list comma separated. e.g.&nbsp;<code>stage<\/code>&nbsp;to sort the list in ascending order and&nbsp;<code>-stage<\/code>&nbsp;to sort the list in descending order.<\/td><td>string<\/td><td><\/td><\/tr><tr><td>q<\/td><td>A string to search against the record fields.<\/td><td>string<\/td><td><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Request Body<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Parameter<\/th><th>Description<\/th><th>Type<\/th><\/tr><\/thead><tbody><tr><td colspan=\"3\">Optional parameters<\/td><\/tr><tr><td>filters<\/td><td>The array of filters to apply when searching records, (See&nbsp;<strong>Filters<\/strong>&nbsp;to get the list of available operators)<\/td><td>Array<\/td><\/tr><tr><td><strong>filters<\/strong>.fieldCode<\/td><td>Field Short Code<\/td><td>Each value is different depending on the field type<\/td><\/tr><tr><td><strong>filters<\/strong>.operator<\/td><td>The operator to apply for search<\/td><td>string<\/td><\/tr><tr><td><strong>filters<\/strong>.value<\/td><td>The value to search for<\/td><td>string<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Example Request<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">POST https:\/\/api.gwapps.com\/v1\/forms\/<em>66b18359dc7659dc4cb98d15<\/em>\/records\/search<\/pre>\n\n\n\n<p>start<\/p>\n\n\n\n<p>Note:&nbsp;If you pass a field that does not exist in the current form you will get a&nbsp;<code>Bad Request<\/code>&nbsp;error response. You can take a look in the Overview section to review the available fields for this form.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">{\n  \"filters\": [\n    {\n      \"fieldCode\": \"company1\",\n      \"operator\": \"EQUALS\",\n      \"value\": \"Vipe\"\n    },\n    {\n      \"fieldCode\": \"stage\",\n      \"operator\": \"IN\",\n      \"value\": [\n        \"stg0\"\n      ]\n    }\n  ]\n}<\/pre>\n\n\n\n<p>Refer to&nbsp;<strong>Filters<\/strong>&nbsp;to see the operators and further examples.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Response<\/h4>\n\n\n\n<p>The response returned will have an array of records, where<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Attribute<\/th><th>Description<\/th><th>Type<\/th><\/tr><\/thead><tbody><tr><td>count<\/td><td>Total users<\/td><td>number<\/td><\/tr><tr><td>current<\/td><td>Current page number<\/td><td>number<\/td><\/tr><tr><td>totalPages<\/td><td>Total pages<\/td><td>number<\/td><\/tr><tr><td>hasNext<\/td><td>Has a next page<\/td><td>boolean<\/td><\/tr><tr><td>records<\/td><td>List of records<\/td><td>Array<\/td><\/tr><tr><td><strong>records<\/strong>._id<\/td><td>The record ID<\/td><td>string<\/td><\/tr><tr><td><strong>records<\/strong>.stage<\/td><td>The record&#8217;s stage<\/td><td>Stage<\/td><\/tr><tr><td><strong>records<\/strong>.shortCode<\/td><td>Depends on field type<\/td><td>Each value is different depending on the field type<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Example Response<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">{\n  \"kind\": \"form#records\",\n  \"count\": 5,\n  \"current\": 1,\n  \"hasNext\": false,\n  \"totalPages\": 1,\n  \"records\": [\n    {\n      \"_id\": \"recordId\",\n      \"meta\": {\n        \"appId\": \"6266db8cbd86d9001a70c9ea\",\n        \"formId\": \"66b18359dc7659dc4cb98d15\"\n      },\n      \"stage\": \"stg0\"\n    }\n  ]\n}<\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Related API Articles<\/h2>\n\n\n\n<p>This article covers details for a specific API call\/endpoint. Details of the overall Records API structure and calls\/endpoints can be found in the <a href=\"https:\/\/support.gwapps.com\/?post_type=ht_kb&amp;p=6232\">GW Apps Records API<\/a> article. Information on creating API Keys can be found within the <a href=\"https:\/\/support.gwapps.com\/knowledge-base\/platform-api-keys\/\" target=\"_blank\" rel=\"noreferrer noopener\">API section<\/a> of the <a href=\"https:\/\/support.gwapps.com\/knowledge-base\/platform-settings-overview\/\" target=\"_blank\" rel=\"noreferrer noopener\">Platform Settings<\/a>, and in the Security &gt; <a href=\"https:\/\/support.gwapps.com\/knowledge-base\/security-api-key-configuration\/\">API Keys<\/a> section of Edit App within each application.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>GW Apps API endpoint that will return a list of records that match the given criteria.<\/p>","protected":false},"author":2,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"content-type":"","footnotes":""},"ht-kb-category":[121],"ht-kb-tag":[76,120,118,119],"class_list":["post-6251","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-api","ht_kb_tag-api","ht_kb_tag-api-call","ht_kb_tag-api-endpoint","ht_kb_tag-api-method"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.1 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Search Records - GW Apps - Support<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/support.gwapps.com\/es\/knowledge-base\/search-records\/\" \/>\n<meta property=\"og:locale\" content=\"es_MX\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Search Records - GW Apps - Support\" \/>\n<meta property=\"og:description\" content=\"GW Apps API endpoint that will return a list of records that match the given criteria.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/support.gwapps.com\/es\/knowledge-base\/search-records\/\" \/>\n<meta property=\"og:site_name\" content=\"GW Apps - Support\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/gwappsinc\" \/>\n<meta property=\"article:modified_time\" content=\"2024-08-27T22:58:12+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@GWApps_Inc\" \/>\n<meta name=\"twitter:label1\" content=\"Tiempo de lectura\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/support.gwapps.com\\\/knowledge-base\\\/search-records\\\/\",\"url\":\"https:\\\/\\\/support.gwapps.com\\\/knowledge-base\\\/search-records\\\/\",\"name\":\"Search Records - GW Apps - Support\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/support.gwapps.com\\\/#website\"},\"datePublished\":\"2024-08-27T22:58:11+00:00\",\"dateModified\":\"2024-08-27T22:58:12+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/support.gwapps.com\\\/knowledge-base\\\/search-records\\\/#breadcrumb\"},\"inLanguage\":\"es\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/support.gwapps.com\\\/knowledge-base\\\/search-records\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/support.gwapps.com\\\/knowledge-base\\\/search-records\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/support.gwapps.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Search Records\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/support.gwapps.com\\\/#website\",\"url\":\"https:\\\/\\\/support.gwapps.com\\\/\",\"name\":\"GW Apps - Support\",\"description\":\"Democratizing web app development for businesses\",\"publisher\":{\"@id\":\"https:\\\/\\\/support.gwapps.com\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/support.gwapps.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"es\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/support.gwapps.com\\\/#organization\",\"name\":\"GW Apps\",\"url\":\"https:\\\/\\\/support.gwapps.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"es\",\"@id\":\"https:\\\/\\\/support.gwapps.com\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/support.gwapps.com\\\/wp-content\\\/uploads\\\/2021\\\/04\\\/GWApps_logo_black.png\",\"contentUrl\":\"https:\\\/\\\/support.gwapps.com\\\/wp-content\\\/uploads\\\/2021\\\/04\\\/GWApps_logo_black.png\",\"width\":745,\"height\":357,\"caption\":\"GW Apps\"},\"image\":{\"@id\":\"https:\\\/\\\/support.gwapps.com\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/gwappsinc\",\"https:\\\/\\\/x.com\\\/GWApps_Inc\",\"https:\\\/\\\/www.linkedin.com\\\/company\\\/gwapps\\\/posts\\\/?feedView=all\",\"https:\\\/\\\/www.youtube.com\\\/channel\\\/UCyN1tnP1Owrti0PYxEkQDaQ\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Search Records - GW Apps - Support","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/support.gwapps.com\/es\/knowledge-base\/search-records\/","og_locale":"es_MX","og_type":"article","og_title":"Search Records - GW Apps - Support","og_description":"GW Apps API endpoint that will return a list of records that match the given criteria.","og_url":"https:\/\/support.gwapps.com\/es\/knowledge-base\/search-records\/","og_site_name":"GW Apps - Support","article_publisher":"https:\/\/www.facebook.com\/gwappsinc","article_modified_time":"2024-08-27T22:58:12+00:00","twitter_card":"summary_large_image","twitter_site":"@GWApps_Inc","twitter_misc":{"Tiempo de lectura":"3 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/support.gwapps.com\/knowledge-base\/search-records\/","url":"https:\/\/support.gwapps.com\/knowledge-base\/search-records\/","name":"Search Records - GW Apps - Support","isPartOf":{"@id":"https:\/\/support.gwapps.com\/#website"},"datePublished":"2024-08-27T22:58:11+00:00","dateModified":"2024-08-27T22:58:12+00:00","breadcrumb":{"@id":"https:\/\/support.gwapps.com\/knowledge-base\/search-records\/#breadcrumb"},"inLanguage":"es","potentialAction":[{"@type":"ReadAction","target":["https:\/\/support.gwapps.com\/knowledge-base\/search-records\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/support.gwapps.com\/knowledge-base\/search-records\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/support.gwapps.com\/"},{"@type":"ListItem","position":2,"name":"Search Records"}]},{"@type":"WebSite","@id":"https:\/\/support.gwapps.com\/#website","url":"https:\/\/support.gwapps.com\/","name":"GW Apps - Soporte","description":"Democratizando el desarrollo de aplicaciones web para empresas","publisher":{"@id":"https:\/\/support.gwapps.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/support.gwapps.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"es"},{"@type":"Organization","@id":"https:\/\/support.gwapps.com\/#organization","name":"GW Apps","url":"https:\/\/support.gwapps.com\/","logo":{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/support.gwapps.com\/#\/schema\/logo\/image\/","url":"https:\/\/support.gwapps.com\/wp-content\/uploads\/2021\/04\/GWApps_logo_black.png","contentUrl":"https:\/\/support.gwapps.com\/wp-content\/uploads\/2021\/04\/GWApps_logo_black.png","width":745,"height":357,"caption":"GW Apps"},"image":{"@id":"https:\/\/support.gwapps.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/gwappsinc","https:\/\/x.com\/GWApps_Inc","https:\/\/www.linkedin.com\/company\/gwapps\/posts\/?feedView=all","https:\/\/www.youtube.com\/channel\/UCyN1tnP1Owrti0PYxEkQDaQ"]}]}},"_links":{"self":[{"href":"https:\/\/support.gwapps.com\/es\/wp-json\/wp\/v2\/ht-kb\/6251","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/support.gwapps.com\/es\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/support.gwapps.com\/es\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/support.gwapps.com\/es\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/support.gwapps.com\/es\/wp-json\/wp\/v2\/comments?post=6251"}],"version-history":[{"count":5,"href":"https:\/\/support.gwapps.com\/es\/wp-json\/wp\/v2\/ht-kb\/6251\/revisions"}],"predecessor-version":[{"id":6298,"href":"https:\/\/support.gwapps.com\/es\/wp-json\/wp\/v2\/ht-kb\/6251\/revisions\/6298"}],"wp:attachment":[{"href":"https:\/\/support.gwapps.com\/es\/wp-json\/wp\/v2\/media?parent=6251"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/support.gwapps.com\/es\/wp-json\/wp\/v2\/ht-kb-category?post=6251"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/support.gwapps.com\/es\/wp-json\/wp\/v2\/ht-kb-tag?post=6251"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}