Verify GSTIN

Use this API to verify if a given GSTIN information exists or not. View the test data and use the information to trigger the validations. The test data are usable only in the test environments such as sandbox.

Authorizations

x-client-id · string · header · required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

x-client-secret · string · header · required

The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your Merchant Dashboard.

Headers

x-cf-signature · string

Send the signature if two-factor authentication is selected as Public Key. More details

Body

application/json

Find the request parameters to retrieve GSTIN information

GSTIN · string · default: 29AAICP2912R1ZR · required

It is the unique number assigned to businesses registered under the Goods and Services Tax (GST) system in India.

Example:

"29AAICP2912R1ZR"

business_name · string · default: UJJIVAN SMALL FINANCE BANK

It is the name of the business to which the GSTIN is issued. The maximum character limit is 200.

Example:

"UJJIVAN SMALL FINANCE BANK"

Response

200

application/json

Success response for retrieving GSTIN information

reference_id · integer

It displays the unique ID created by Cashfree Payments for reference purposes. format: int64

Example:

12345

GSTIN · string

Unique identification number assigned to businesses registered under the Goods and Services Tax (GST) system in India.

Example:

"29AAICP2912R1ZR"

legal_name_of_business · string

Legal name of the business registered under the GST system.

Example:

"UJJIVAN SMALL FINANCE BANK LIMITED"

trade_name_of_business · string

Trade name of the business registered under the GST system.

Example:

"UJJIVAN SMALL FINANCE BANK"

center_jurisdiction · string

Center jurisdiction under which the business falls.

Example:

"I-A RANGE"

state_jurisdiction · string

State jurisdiction under which the business falls.

Example:

"GUWAHATI - A - 1"

date_of_registration · string

Date of GST registration for the business.

Example:

"2017-09-30"

constitution_of_business · string

Constitution type of the business, such as Private Limited, Proprietorship, etc.

Example:

"Public Limited Company"

taxpayer_type · string

Taxpayer type, indicating whether the business is a Regular taxpayer, Composition taxpayer, etc.

Example:

"Regular"

gst_in_status · string

Current status of the GSTIN.

Example:

"Active"

last_update_date · string

Date when the GST details were last updated.

Example:

"2022-03-01"

nature_of_business_activities · string[]

List of activities performed by the business, such as Retail Business, Supplier of Services, etc.

Activity performed by the business, such as Retail Business, Supplier of Services, etc.

principal_place_address · string

Complete principal place address of the business.

Example:

"First Floor 3512-DISPUR Prithivi Mansion opp. KFC building G.S. Road, Lachit Nagar Assam 781007"

principal_place_split_address · object

Split components of the principal place address.

Show child attributes

additional_address_array · object[]

List of additional addresses associated with the business.

Show child attributes

valid · boolean

Indicates whether the GSTIN is valid.

message · string

The message indicates whether the GSTIN exists.