Verify

The Verify GST function serves the purpose of confirming the validity and accuracy of a Goods and Services Tax Identification Number (GSTIN) associated with a business or entity.

How to Setup

1 Navigate to Workspace > Workflows, and click on the flow created for Verify GST. If you need understanding in creating a workflow, refer to the step-by-step guide here.

2 Hover over the plus (+) symbol and select Workflow. From the list, click Verify GST to add it.

3 Click on the newly added workflow, then select the General tab to customize your preferences.

Manage General

(*) Indicates an action to be mandatory.

Name	Description
Display Name*	Set a name to the workflow for easy identification.
Description	Summarize the purpose and functionality of this workflow module.
Enable	This toggle is enabled by default. When enabled, the particular workflow module begins its execution. Conversely, if disabled, the workflow module remains inactive and won't proceed.
Skip	Allows the user to skip this specific workflow module during execution. When selected, it provides an option to bypass the particular workflow without affecting other modules in the sequence.
Rule	This determines the criteria for triggering the particular workflow module. When the selected rule is evaluated, and is satisfied, the workflow proceeds as provided. If not, the workflow will not be executed. Note: If no rules are set, the workflow defaults to its standard action without any rule. For more information about the rules, refer here.

4 Then, click on the Configs tab to set the necessary configurations.

Manage Configs

Name

Description

GSTIN Claims

Claims specify the information that should appear in the generated response. Note that only the selected claims will appear in the final response. The claims for Verify GSTIN are, verify_gstin@date_of_cancellation: The date when the GST registration was canceled. verify_gstin@percentage_in_cash_fy: The percentage of transactions conducted in cash for the financial year. verify_gstin@nature_of_core_business_activity_code: The code representing the primary business activity. verify_gstin@nature_of_core_business_activity_description: A description of the primary business activity. verify_gstin@constitution_of_business: The legal structure or type of business entity (e.g., sole proprietorship, partnership, corporation) verify_gstin@gstin: The Goods and Services Tax Identification Number assigned to the business. verify_gstin@client_id: A unique identifier assigned to the business. verify_gstin@filing_frequency: The frequency with which the business files GST returns (e.g., monthly, quarterly). verify_gstin@filing_status: The current status of GST return filings (e.g., filed, pending). verify_gstin@address_details: Address of the business, including street, city, state, and postal code. verify_gstin@legal_name: The official legal name of the business entity. verify_gstin@promoters: Key individuals promoting or leading the business. verify_gstin@less_info: Indicates if there is limited information available about the business. verify_gstin@taxpayer_type: The classification of the taxpayer (e.g., regular taxpayer, composition taxpayer). verify_gstin@business_name: The trade name or commonly used name of the business. verify_gstin@gstin_verified: This denotes whether the GST verification is completed ("True" if completed, "False" if not). verify_gstin@gstin_verified_at: Timestamp (in Unix epoch format) indicating when the GSTIN was verified. verify_gstin@address: The physical location or address of the business. verify_gstin@center_jurisdiction: The central tax jurisdiction under which the business falls. verify_gstin@contact_details: Contact information for the business, including phone numbers and email addresses. verify_gstin@pan_number: The PAN assigned to the business for tax purposes. verify_gstin@annual_turnover: The total revenue generated by the business in a year. verify_gstin@annual_turnover_fy: The annual turnover of the business for the financial year. verify_gstin@state_jurisdiction: The state tax jurisdiction under which the business falls. verify_gstin@aadhaar_validation_date: The date when Aadhaar validation was completed. verify_gstin@field_visit_conducted: Indicates whether a field visit was conducted to verify business details ("True" if completed, "False" if not). verify_gstin@less_info: Indicates if the GSTIN verification contains incomplete or limited information ("True" if less information is available, "False" otherwise). verify_gstin@hsn_info: The Harmonized System of Nomenclature (HSN) details associated with the business, as per the GSTIN record. verify_gstin@aadhaar_validation: Indicates whether the Aadhaar details have been validated ("True" if completed, "False" if not). verify_gstin@date_of_registration: The date when the business was registered for GST ("True" if completed, "False" if not). verify_gstin@nature_bus_activities: A description of the various business activities undertaken by the entity.

5 After you've configured everything needed, click on SAVE.

6 Proceed to attach the workflow to the relevant application for execution. Refer to the instructions on how to attach a workflow to an application here.

How it Works

1 Launch Postman or your preferred API tool and execute the flow by configuring the suitable Method, URL, and Body settings. If you're seeking guidance on how to perform these actions, see here.

2 Upon initiating the API call, a verification request will be sent to your configured Verification Way settings.

3 Based on the request, execute the flow in an incognito browser and follow the prompts to complete the verification process.

4 Begin by providing the GSTIN Number, and click on Submit.

5 The verification process will be completed if the entered data is valid.

If "force onboarding" is enabled in the API request, all users, regardless of status, will be directed to the onboarding flow first, followed by the verification flow if configured.

6 The response can differ depending on the chosen Verification Way and Notification Way configurations. To know more, see here.

7 Here is a sample response for Verify GST:

{
   "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
   "user_id": "mark@gmail.com",
   "workflow": "verification",
   "date_of_cancellation": "1800-xx-xx",
   "percentage_in_cash_fy": "xx",
   "nature_of_core_business_activity_code": "SPO",
   "nature_of_core_business_activity_description": "Service Provider and Others",
   "constitution_of_business": "Private Limited Company",
   "gstin": "33Axxxxxxxxxxxx",
   "client_id": "corporate_gstin_advanced_xxxxxxxx",
   "filing_frequency": "xx",
   "filing_status": "xxxxxxxxxx",
   "address_details": "xx",
   "legal_name": "ezto",
   "promoters": "xxxxxxxxxxxxxxxxxxxxxxx",
   "less_info": "true/false",
   "taxpayer_type": "Regular",
   "business_name": "ezto",
   "gstin_verified": "true/false",
   "hsn_info": "xxxxxxxxxxxxxxxxxxxxxxx",
   "gstin_verified_at": "1719569072",
   "address": "xxxx",
   "center_jurisdiction": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
   "contact_details": "xxxxxxxxxxxxxxxxxxxxxxxxxxx",
   "pan_number": "AWxxxxxxxx",
   "annual_turnover": "xxxxxxxxxxxxxxxx",
   "annual_turnover_fy": "xxxxxxxxx",
   "state_jurisdiction": "xxxxxxxxxxxxxxxxxxxxx",
   "aadhaar_validation_date": "xxxxxxxxxx",
   "field_visit_conducted": "Yes/No",
   "aadhaar_validation": "Yes/No",
   "date_of_registration": "2000-xx-xx",
   "nature_bus_activities": "[Supplier of Services]"
}