Get Forms

This API fetches the meta information of all the forms present in a Zoho Creator application.

Request URL

https://<base_url>/api/v2/<account_owner_name>/<app_link_name>/forms

Request method

GET

Header

KeyValueDescription
AuthorizationZoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxfAn authentication token (authtoken) allows users to access apps and APIs without having to enter their login credentials each time.
environmentdevelopment/stageRefers to the environment stage.
Note: By default, production value will be considered for the environment header.

OAuth scope

scope=ZohoCreator.meta.application.READ

where,

base_urlthe base URL of your Creator account
For example, it's creator.zoho.com if your account belongs to Zoho's US DC, and is creator.zoho.eu if it belongs to Zoho's EU DC.
account_owner_namethe username of the Creator account's owner
app_link_namethe link name of the application from which you want to fetch the form meta information
Form types
  • A normal/DB form will have 1 as its type value
  • A stateless form will have 2 as its type value
Possible Errors

Refer to this page for the list of error codes and messages.

Sample Request for Production environment

Copiedcurl "https://creator.zoho.com/api/v2/jason18/zylker-store/forms"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

This sample request will fetch the meta information of all the forms present in the Zylker Store application.

Sample Request for Development/ Stage environments

Copiedcurl "https://creator.zoho.com/api/v2/jason18/c6/sections"
-X GET 
-H 'Authorization: Zoho-oauthtoken 1000.f8a33d38b8184db27d71796f4b883809.881b08a04bdaf09adfcf343ae491c7d0'  
-H 'environment: development'

Sample Response

Copied{
  "code": 3000,
  "forms": [
    {
      "display_name": "Add Order",
      "link_name": "Order_Form",
      "type": 1
    },
    {
      "display_name": "Add Inventory",
      "link_name": "Inventory_Form",
      "type": 1
    },
    {
      "display_name": "Order Stateless Form",
      "link_name": "Order_Stateless_Form",
      "type": 2
    }
  ]
}