{"id":9419,"date":"2021-01-12T23:33:00","date_gmt":"2021-01-12T23:33:00","guid":{"rendered":"https:\/\/kb-support.com\/\/?post_type=article&#038;p=9419"},"modified":"2024-10-24T23:48:22","modified_gmt":"2024-10-24T20:48:22","slug":"forms-rest-api-route","status":"publish","type":"article","link":"https:\/\/kb-support.com\/articles\/forms-rest-api-route\/","title":{"rendered":"Forms REST API Route"},"content":{"rendered":"<h3>Authentication <a id=\"authentication\" href=\"#authentication\">#<\/a><\/h3>\n<p>No authentication is required for this route.<\/p>\n<h3>Schema <a id=\"schema\" href=\"#schema\">#<\/a><\/h3>\n<p>When working with the Forms REST API route the following fields can be expected in any responses.<\/p>\n<p><!--more--><\/p>\n<table style=\"height: 1176px; width: 100%; border-collapse: collapse; border-color: #a2abb3; border-style: solid;\" border=\"1\">\n<tbody>\n<tr style=\"height: 48px;\">\n<td style=\"vertical-align: top; height: 48px; width: 33%; border-color: #a2abb3; border-style: solid;\"><code>id<\/code><br \/>\n<em>integer<\/em><\/td>\n<td style=\"vertical-align: top; height: 48px; border-style: solid; border-color: #a2abb3; width: 67%;\">Unique identifier for the form<br \/>\n<em>Read Only<\/em><\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"vertical-align: top; height: 48px; width: 33%; border-color: #a2abb3; border-style: solid;\"><code>date<\/code><br \/>\n<em>string<\/em><\/td>\n<td style=\"vertical-align: top; height: 48px; border-style: solid; border-color: #a2abb3; width: 67%;\">The date the form was published, in the site&#8217;s timezone<\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"vertical-align: top; height: 48px; width: 33%; border-color: #a2abb3; border-style: solid;\"><code>date_gmt<\/code><br \/>\n<em>string<\/em><\/td>\n<td style=\"vertical-align: top; height: 48px; border-style: solid; border-color: #a2abb3; width: 67%;\">The date the form was published, as GMT<\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"vertical-align: top; height: 48px; width: 33%; border-color: #a2abb3; border-style: solid;\"><code>modified<\/code><br \/>\n<em>string<\/em><\/td>\n<td style=\"vertical-align: top; height: 48px; border-style: solid; border-color: #a2abb3; width: 67%;\">The date the form was last modified, in the site&#8217;s timezone<\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"vertical-align: top; height: 48px; width: 33%; border-color: #a2abb3; border-style: solid;\"><code>modified_gmt<\/code><br \/>\n<em>string<\/em><\/td>\n<td style=\"vertical-align: top; height: 48px; border-style: solid; border-color: #a2abb3; width: 67%;\">The date the form was last modified, as GMT<\/td>\n<\/tr>\n<tr style=\"height: 72px;\">\n<td style=\"vertical-align: top; height: 72px; width: 33%; border-color: #a2abb3; border-style: solid;\"><code>status<\/code><br \/>\n<em>string<\/em><\/td>\n<td style=\"vertical-align: top; height: 72px; border-style: solid; border-color: #a2abb3; width: 67%;\">The named status of the form<br \/>\n<em>One of: <code>publish<\/code>, <code>future<\/code>, <code>draft<\/code>, <code>pending<\/code>, <code>private<\/code><\/em><\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"vertical-align: top; height: 48px; width: 33%; border-color: #a2abb3; border-style: solid;\"><code>title<\/code><br \/>\n<em>object<\/em><\/td>\n<td style=\"vertical-align: top; height: 48px; border-style: solid; border-color: #a2abb3; width: 67%;\">The title of the form<\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"vertical-align: top; height: 48px; width: 33%; border-color: #a2abb3; border-style: solid;\"><code>meta<\/code><br \/>\n<em>object<\/em><\/td>\n<td style=\"vertical-align: top; height: 48px; border-style: solid; border-color: #a2abb3; width: 67%;\">Meta fields<\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"vertical-align: top; height: 48px; width: 33%; border-color: #a2abb3; border-style: solid;\"><code>fields<\/code><br \/>\n<em>object<\/em><\/td>\n<td style=\"vertical-align: top; height: 48px; border-style: solid; border-color: #a2abb3; width: 67%;\">Form fields<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"vertical-align: top; height: 24px; width: 33%; border-color: #a2abb3; border-style: solid;\"><code>links<\/code><br \/>\n<em>object<\/em><\/td>\n<td style=\"vertical-align: top; height: 24px; border-style: solid; border-color: #a2abb3; width: 67%;\">Links associated with the ticket<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3><\/h3>\n<h3>List Forms\u00a0<a id=\"list-forms\" href=\"#list-forms\">#<\/a><\/h3>\n<p>Query this endpoint to retrieve a collection of forms. The response you receive can be controlled and filtered using the URL query parameters below.<\/p>\n<h4>Definition <a id=\"list-forms-definition\" href=\"#list-forms-definition\">#<\/a><\/h4>\n<p><code>GET \/kbs\/v1\/forms <\/code><\/p>\n<h4>Example Request <a id=\"list-forms-example\" href=\"#list-forms-example\">#<\/a><\/h4>\n<p><code>$ curl https:\/\/example.com\/wp-json\/kbs\/v1\/forms<\/code><\/p>\n<h4>Arguments <a id=\"list-forms-arguments\" href=\"#list-forms-arguments\">#<\/a><\/h4>\n<table style=\"width: 100%; border-collapse: collapse; border-color: #a2abb3; border-style: solid; height: 480px;\" border=\"1\">\n<tbody>\n<tr style=\"height: 48px;\">\n<td style=\"vertical-align: top; border-style: solid; border-color: #a2abb3; width: 33%; height: 48px;\"><code>page<\/code><\/td>\n<td style=\"border-style: solid; border-color: #a2abb3; vertical-align: top; width: 67%; height: 48px;\">Current page of the collection<br \/>\n<em>Default: <code>1<\/code><\/em><\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"vertical-align: top; border-style: solid; border-color: #a2abb3; width: 33%; height: 48px;\"><code>per_page<\/code><\/td>\n<td style=\"border-style: solid; border-color: #a2abb3; vertical-align: top; width: 67%; height: 48px;\">Maximum number of items to be returned in result set<br \/>\n<em>Default: <code>10<\/code><\/em><\/td>\n<\/tr>\n<tr>\n<td style=\"vertical-align: top; border-style: solid; border-color: #a2abb3; width: 33%;\"><code>search<\/code><\/td>\n<td style=\"border-style: solid; border-color: #a2abb3; vertical-align: top; width: 67%;\">Limit results to those matching a string<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"vertical-align: top; border-style: solid; border-color: #a2abb3; width: 33%; height: 24px;\"><code>exclude<\/code><\/td>\n<td style=\"border-style: solid; border-color: #a2abb3; vertical-align: top; width: 67%; height: 24px;\">Ensure result set excludes specific post IDs<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"vertical-align: top; border-style: solid; border-color: #a2abb3; width: 33%; height: 24px;\"><code>include<\/code><\/td>\n<td style=\"border-style: solid; border-color: #a2abb3; vertical-align: top; width: 67%; height: 24px;\">Limit result set to specific post IDs<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"vertical-align: top; border-style: solid; border-color: #a2abb3; width: 33%; height: 24px;\"><code>offset<\/code><\/td>\n<td style=\"border-style: solid; border-color: #a2abb3; vertical-align: top; width: 67%; height: 24px;\">Offset the result set by a specific number of items<\/td>\n<\/tr>\n<tr style=\"height: 72px;\">\n<td style=\"vertical-align: top; border-style: solid; border-color: #a2abb3; width: 33%; height: 72px;\"><code>order<\/code><\/td>\n<td style=\"border-style: solid; border-color: #a2abb3; vertical-align: top; width: 67%; height: 72px;\">Order sort attribute ascending or descending<br \/>\n<em>Default: <\/em><code style=\"font-size: inherit;\"><em>desc<\/em><br \/>\n<\/code><em>One of:\u00a0<code style=\"font-size: inherit;\">asc<\/code><span style=\"font-family: inherit; font-size: inherit;\">,\u00a0<\/span><code style=\"font-size: inherit;\">desc<\/code><\/em><\/td>\n<\/tr>\n<tr style=\"height: 72px;\">\n<td style=\"vertical-align: top; border-style: solid; border-color: #a2abb3; width: 33%; height: 72px;\"><code>orderby<\/code><\/td>\n<td style=\"border-style: solid; border-color: #a2abb3; vertical-align: top; width: 67%; height: 72px;\">Sort collection by object attribute<br \/>\n<em>Default: <code style=\"font-size: inherit;\">title<\/code><\/em><br \/>\n<em>One of: <code style=\"font-size: inherit;\">id<\/code><span style=\"font-family: inherit; font-size: inherit;\">,\u00a0<\/span><code style=\"font-size: inherit;\">date<\/code><span style=\"font-family: inherit; font-size: inherit;\">, <code>modified<\/code><\/span><span style=\"font-family: inherit; font-size: inherit;\">,\u00a0<\/span><code style=\"font-size: inherit;\">include<\/code>, <code>title<\/code><\/em><\/td>\n<\/tr>\n<tr style=\"height: 72px;\">\n<td style=\"vertical-align: top; border-style: solid; border-color: #a2abb3; width: 33%; height: 72px;\"><code>status<\/code><br \/>\n<em>string | array<\/em><\/td>\n<td style=\"border-style: solid; border-color: #a2abb3; vertical-align: top; width: 67%; height: 72px;\">Limit result set to forms assigned one or more statuses<br \/>\n<em>Default: <code>publish<\/code><\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"vertical-align: top; border-style: solid; border-color: #a2abb3; width: 33%; height: 24px;\"><code>slug<\/code><\/td>\n<td style=\"border-style: solid; border-color: #a2abb3; vertical-align: top; width: 67%; height: 24px;\">Limit result set to posts with one or more specific slugs<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3><\/h3>\n<h3>Retrieve a Single Form\u00a0<a id=\"retrieve-form\" href=\"#retrieve-form\">#<\/a><\/h3>\n<h4>Definitions <a id=\"retrieve-form-definition\" href=\"#retrieve-form-definition\">#<\/a><\/h4>\n<p><code>GET \/kbs\/v1\/forms\/&lt;id&gt;<\/code><\/p>\n<h4>Example Request <a id=\"retrieve-form-example\" href=\"#retrieve-form-example\">#<\/a><\/h4>\n<p><code>$ curl https:\/\/example.com\/wp-json\/kbs\/v1\/forms\/&lt;id&gt;<\/code><\/p>\n<h4>Arguments <a id=\"retrieve-form-arguments\" href=\"#retrieve-form-arguments\">#<\/a><\/h4>\n<table style=\"width: 100%; border-collapse: collapse; border-color: #a2abb3; border-style: solid;\" border=\"1\">\n<tbody>\n<tr style=\"height: 48px;\">\n<td style=\"vertical-align: top; border-style: solid; border-color: #a2abb3; width: 33%; height: 48px;\"><code>id<\/code><\/td>\n<td style=\"border-style: solid; border-color: #a2abb3; vertical-align: top; width: 67%; height: 48px;\">WP Post ID of the form<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n","protected":false},"excerpt":{"rendered":"<p>Authentication # No authentication is required for this route. Schema # When working with the Forms REST API route the following fields can be expected in any responses.<\/p>\n","protected":false},"author":1452,"featured_media":0,"comment_status":"closed","ping_status":"open","template":"elementor_header_footer","meta":{"_kbs_article_restricted":0,"_kbs_article_views":3189,"_kbs_article_views_2026-05":12,"_kbs_edd_article_customers":0,"_kbs_edd_article_restricted_to_products":[],"footnotes":""},"article_category":[24],"article_tag":[141],"_links":{"self":[{"href":"https:\/\/kb-support.com\/wp-json\/wp\/v2\/articles\/9419"}],"collection":[{"href":"https:\/\/kb-support.com\/wp-json\/wp\/v2\/articles"}],"about":[{"href":"https:\/\/kb-support.com\/wp-json\/wp\/v2\/types\/article"}],"author":[{"embeddable":true,"href":"https:\/\/kb-support.com\/wp-json\/wp\/v2\/users\/1452"}],"replies":[{"embeddable":true,"href":"https:\/\/kb-support.com\/wp-json\/wp\/v2\/comments?post=9419"}],"version-history":[{"count":3,"href":"https:\/\/kb-support.com\/wp-json\/wp\/v2\/articles\/9419\/revisions"}],"predecessor-version":[{"id":21472,"href":"https:\/\/kb-support.com\/wp-json\/wp\/v2\/articles\/9419\/revisions\/21472"}],"wp:attachment":[{"href":"https:\/\/kb-support.com\/wp-json\/wp\/v2\/media?parent=9419"}],"wp:term":[{"taxonomy":"article_category","embeddable":true,"href":"https:\/\/kb-support.com\/wp-json\/wp\/v2\/article_category?post=9419"},{"taxonomy":"article_tag","embeddable":true,"href":"https:\/\/kb-support.com\/wp-json\/wp\/v2\/article_tag?post=9419"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}