GSTIN Verification

With this API, you will obtain information such as GSTIN Status (Active/Suspended/Cancelled), company name, and address, providing a comprehensive insight into the GST compliance status of your clientele. Enhance operational efficiency and minimise risks associated with non-compliance by incorporating Instantpay's GSTIN Verification API solution into your identity verification toolkit.

Header Parameters

NameTypeDescriptionMandatory (M) , Optional (O)Provided by INSTANTPAY (Y/N)
X-Ipay-Auth-CodeStringAuth Code -1 (Fixed)MY
X-Ipay-Client-IdStringUnique Client IDMY
X-Ipay-Client-SecretStringUnique secret keyMY
X-Ipay-Endpoint-IpStringEnd Customer IP AddressMN

Request Parameters

NameTypeMandatory (M) , Optional (O)Description
gstNumberStringMGST Number of Company
externalRefStringMYour Unique Transaction Id
lattitudeStringMEnd Customer Latitude.
longitudeStringMEnd Customer Longitude.

Sample Request

curl --location --request POST '' \
--header 'X-Ipay-Auth-Code: {{authCode}}' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{clientSecret}}' \
--header 'X-Ipay-Endpoint-Ip: {{endPointIP}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gstNumber" : "24DACP2435DZY",
    "externalRef"   :"123456789",
    "latitude" :   "25.**41",
    "longitude" :   "85.**76"

POST /identity/verifyGstin HTTP/1.1
X-Ipay-Auth-Code: {{authCode}}
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: {{endPointIP}}
Content-Type: application/json

    "gstNumber" : "24DACP2435DZY",
    "externalRef"   :"123456789",
    "latitude" :   "25.**41",
    "longitude" :   "85.**76"


Response Parameters

statuscodeStringInstantPay Status Code
actcodeStringAction Code
statusStringStatus message
dataArrayResponse Data (If Present)
timestampStringCurrent time (YYYY-MM-DD HH:II:SS)
ipay_uuidStringRequest reference number
orderidStringTransaction Id ( If transaction otherwise it is null )


Note :

1- externalRef must be unique and in alpha numeric characters.
2- Latitude and Longitude must be represented in degrees with 4 digits after decimal.

Sample Response

    "statuscode": "TXN",
    "actcode": null,
    "status": "Transaction Successful",
    "data": {
        "pool": {
            "referenceId": "1220**********LKPR",
            "openingBalance": "16.82",
            "paymentAmount": "1.18",
            "mode": "DR",
            "closingBalance": "15.64"
        "gstDetails": {
            "gstin": "24DACP2435DZY",
            "lgnm": "Business Name",
            "stj": "State Name",
            "ctj": "City Name",
            "rgdt": "05/01/2022",
            "ctb": "Proprietorship",
            "dty": "Regular",
            "nba": [
                "Supplier of Services",
                "Retail Business",
                "Wholesale Business"
            "sts": "Active",
            "cxdt": "",
            "tradeNam": "Payby Digital Service",
            "stjCd": "GJ067",
            "ctjCd": "VC0303",
            "pradr": {
                "addr": {
                    "bnm": "Sample Address",
                    "st": "Street Name",
                    "loc": "Locality",
                    "bno": "Address",
                    "stcd": "State Name",
                    "flno": "Floor Number",
                    "lt": "",
                    "lg": "",
                    "dst": "Surat",
                    "city": "",
                    "pncd": "394190"
                "ntr": "Supplier of Services, Retail Business, Wholesale Business"
            "adadr": [],
            "filingFreq": null,
            "lastUpdated": "31/Mar/2022"
    "timestamp": "2022-04-05 14:35:12",
    "ipay_uuid": "h00695fd4116-152b-4fd0-864e-22e7c9ce4bbb",
    "orderid": "12************KPR",
    "environment": "LIVE",
Click Try It! to start a request and see the response here!