post https://api.instantpay.in/identity/verifyGstinPlus
Go beyond standard GSTIN verification with Instantpay's GSTIN Verification Plus API solution. This advanced tool offers additional features to enhance the accuracy and depth of your GST identification number verification. Businesses can access comprehensive details, ensuring a more thorough understanding of the GST registration status. Integrate GSTIN Verification Plus into your system for an extra layer of verification, minimising the risk of fraudulent activities.
Header Parameters
| Name | Type | Description | Mandatory (M) , Optional (O) | Provided by INSTANTPAY (Y/N) |
|---|---|---|---|---|
| X-Ipay-Auth-Code | String | Auth Code -1 (Fixed) | M | Y |
| X-Ipay-Client-Id | String | Unique Client ID | M | Y |
| X-Ipay-Client-Secret | String | Unique secret key | M | Y |
| X-Ipay-Endpoint-Ip | String | End Customer IP Address | M | N |
Request Parameters
| Name | Type | Mandatory (M) , Optional (O) | Description |
|---|---|---|---|
| gstNumber | String | M | GST Number of Company |
| externalRef | String | M | Your Unique Transaction Id |
| lattitude | String | M | End Customer Latitude. |
| longitude | String | M | End Customer Longitude. |
Sample Request
curl --location --request POST 'https://api.instantpay.in/identity/verifyGstin' \
--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":"18AABCU9603R1ZM",
"consent":"Y",
"latitude":0.99,
"longitude":38,
"externalRef":"jdnjdi89"
}'
POST /identity/verifyGstin HTTP/1.1
Host: api.instantpay.in
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":"18AABCU9603R1ZM",
"consent":"Y",
"latitude":0.99,
"longitude":38,
"externalRef":"jdnjdi89"
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| statuscode | String | InstantPay Status Code |
| actcode | String | Action Code |
| status | String | Status message |
| data | Array | Response Data (If Present) |
| timestamp | String | Current time (YYYY-MM-DD HH:II:SS) |
| ipay_uuid | String | Request reference number |
| orderid | String | Transaction Id ( If transaction otherwise it is null ) |
| environment | String | Live/Sandbox |
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": {
"gstinPlusData": {
"aggregateTurnOver": "Slab: Rs. 500 Cr. and above",
"authorizedSignatory": [
"Ittira Poonollil Davis "
],
"businessConstitution": "Public Limited Company",
"businessNature": [
"Retail Business",
"Supplier of Services",
"Recipient of Goods or Services",
"Office / Sale Office",
"Others"
],
"canFlag": "NA",
"centralJurisdiction": "Commissionerate - GUWAHATI,Division - GUWAHATI I DIVISION,Range - I-A RANGE (Jurisdictional Office)",
"complianceRating": "NA",
"contact": {
"email": "[email protected]",
"mobileNo": 9999999999
},
"currentRegistrationStatus": "Active",
"filingStatus": [
[
{
"fy": "2023-2024",
"taxp": "August",
"mof": "ONLINE",
"dof": "10/09/2023",
"rtntype": "GSTR1",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2023-2024",
"taxp": "July",
"mof": "ONLINE",
"dof": "11/08/2023",
"rtntype": "GSTR1",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2023-2024",
"taxp": "June",
"mof": "ONLINE",
"dof": "11/07/2023",
"rtntype": "GSTR1",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2023-2024",
"taxp": "May",
"mof": "ONLINE",
"dof": "09/06/2023",
"rtntype": "GSTR1",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2023-2024",
"taxp": "April",
"mof": "ONLINE",
"dof": "11/05/2023",
"rtntype": "GSTR1",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2022-2023",
"taxp": "March",
"mof": "ONLINE",
"dof": "11/04/2023",
"rtntype": "GSTR1",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2022-2023",
"taxp": "February",
"mof": "ONLINE",
"dof": "11/03/2023",
"rtntype": "GSTR1",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2022-2023",
"taxp": "January",
"mof": "ONLINE",
"dof": "10/02/2023",
"rtntype": "GSTR1",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2022-2023",
"taxp": "December",
"mof": "ONLINE",
"dof": "11/01/2023",
"rtntype": "GSTR1",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2022-2023",
"taxp": "November",
"mof": "ONLINE",
"dof": "09/12/2022",
"rtntype": "GSTR1",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2023-2024",
"taxp": "August",
"mof": "ONLINE",
"dof": "20/09/2023",
"rtntype": "GSTR3B",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2023-2024",
"taxp": "July",
"mof": "ONLINE",
"dof": "19/08/2023",
"rtntype": "GSTR3B",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2023-2024",
"taxp": "June",
"mof": "ONLINE",
"dof": "20/07/2023",
"rtntype": "GSTR3B",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2023-2024",
"taxp": "May",
"mof": "ONLINE",
"dof": "20/06/2023",
"rtntype": "GSTR3B",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2023-2024",
"taxp": "April",
"mof": "ONLINE",
"dof": "20/05/2023",
"rtntype": "GSTR3B",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2022-2023",
"taxp": "March",
"mof": "ONLINE",
"dof": "20/04/2023",
"rtntype": "GSTR3B",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2022-2023",
"taxp": "February",
"mof": "ONLINE",
"dof": "18/03/2023",
"rtntype": "GSTR3B",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2022-2023",
"taxp": "January",
"mof": "ONLINE",
"dof": "20/02/2023",
"rtntype": "GSTR3B",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2022-2023",
"taxp": "December",
"mof": "ONLINE",
"dof": "20/01/2023",
"rtntype": "GSTR3B",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2022-2023",
"taxp": "November",
"mof": "ONLINE",
"dof": "20/12/2022",
"rtntype": "GSTR3B",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2021-2022",
"taxp": "Annual",
"mof": "ONLINE",
"dof": "31/12/2022",
"rtntype": "GSTR9",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2020-2021",
"taxp": "Annual",
"mof": "ONLINE",
"dof": "08/12/2021",
"rtntype": "GSTR9",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2019-2020",
"taxp": "Annual",
"mof": "ONLINE",
"dof": "27/02/2021",
"rtntype": "GSTR9",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2018-2019",
"taxp": "Annual",
"mof": "ONLINE",
"dof": "29/09/2020",
"rtntype": "GSTR9",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2017-2018",
"taxp": "Annual",
"mof": "ONLINE",
"dof": "23/08/2019",
"rtntype": "GSTR9",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2021-2022",
"taxp": "Annual",
"mof": "ONLINE",
"dof": "31/12/2022",
"rtntype": "GSTR9C",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2020-2021",
"taxp": "Annual",
"mof": "ONLINE",
"dof": "24/12/2021",
"rtntype": "GSTR9C",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2019-2020",
"taxp": "Annual",
"mof": "ONLINE",
"dof": "27/02/2021",
"rtntype": "GSTR9C",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2018-2019",
"taxp": "Annual",
"mof": "ONLINE",
"dof": "03/10/2020",
"rtntype": "GSTR9C",
"arn": "NA",
"status": "Filed"
},
{
"fy": "2017-2018",
"taxp": "Annual",
"mof": "ONLINE",
"dof": "26/09/2019",
"rtntype": "GSTR9C",
"arn": "NA",
"status": "Filed"
}
]
],
"gstin": "18AABCU9603R1ZM",
"isFieldVisitConducted": "No",
"legalName": "UJJIVAN SMALL FINANCE BANK LIMITED",
"mandateEInvoice": "Yes",
"otherBusinessAddress": [
{
"businessNature": "Office / Sale Office, Supplier of Services, Recipient of Goods or Services, Retail Business, Others",
"detailedAddress": "Mirza Santipur NH-37, PS-Palashbari PO Mirza, Dist-Kamrup Rural Kamrup, Assam, 781125",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Mirza Santipur NH-37, PS-Palashbari PO Mirza, Dist-Kamrup Rural Kamrup, Assam, 781125"
},
{
"businessNature": "Retail Business, Office / Sale Office, Supplier of Services, Recipient of Goods or Services, Others",
"detailedAddress": "N.A.C.C.I. Foundation, CHAMBER BHAWAN 3559-Tezpur Binjraj Road P. o. and P.S. - Tezpur, Dist. Binjraj Road, P. o. and P.S. - Tezpur, Dist., Sonitpur, Assam, 784154",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "N.A.C.C.I. Foundation, CHAMBER BHAWAN 3559-Tezpur, Binjraj Road P. o. and P.S. - Tezpur, Dist., Binjraj Road, P. o. and P.S. - Tezpur, Dist., Sonitpur, Assam, 784154"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "Ground Floor, House No. 9 Kalapahar - 3513 Ground Floor, House No. 9 , Lokhra Road -, Kamrup, Assam, 781018",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Ground Floor, House No. 9, Kalapahar - 3513 Ground Floor, House No. 9, , Lokhra Road -, Kamrup, Assam, 781018"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "Maligaon Gate No-1, Opp. Maligaon - 3514 Maligaon Gate No-1 Opp.Guwahati, Guwahati Kamrup, Assam, 781011",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Maligaon Gate No-1, Opp. Maligaon - 3514, Maligaon Gate No-1 Opp.Guwahati, Guwahati, Kamrup, Assam, 781011"
},
{
"businessNature": "Retail Business, Others, Supplier of Services, Recipient of Goods or Services",
"detailedAddress": "Ground Floor , Sonapur - 3531, New Market Sonapur, Kamrup, Assam, 782402",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Ground Floor , Sonapur - 3531, New Market Sonapur, Kamrup, Assam, 782402"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "Narengi Tinali, Narengi - 3533 MT Road, Narengi Tinali MT Road, Near- EG Nursing home opposite side, Kamrup, Assam, 781026",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Narengi Tinali, Narengi - 3533, MT Road, Narengi Tinali, MT Road, Near- EG Nursing home opposite side, Kamrup, Assam, 781026"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "Mirza Santipur NH-37, Azara - 3538 PS - Palashbari PO - Mirza, Dist - Kamrup Rural, Assam, , Kamrup, Assam, 781125",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Mirza Santipur NH-37, Azara - 3538, PS - Palashbari PO - Mirza, , Dist - Kamrup Rural, Assam, , Kamrup, Assam, 781125"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "Vill- Hajo, Majursupa near Pakhamela Sualkuchi - 3539 PO-Hajo, Dist-Kamrup Rural, Assam, Kamrup, Assam, 781102",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Vill- Hajo, Majursupa near Pakhamela, Sualkuchi - 3539 PO-Hajo, , Dist-Kamrup Rural, Assam, Kamrup, Assam, 781102"
},
{
"businessNature": "Retail Business, Others, Supplier of Services, Recipient of Goods or Services",
"detailedAddress": "Ground and 1st Floor, Nagaon - 3560 Opp Haibargaon Boys High School , Haibargaon AT Road, Nagaon, Assam, 782002",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Ground and 1st Floor, Nagaon - 3560, Opp Haibargaon Boys High School , Haibargaon, AT Road, Nagaon, Assam, 782002"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "Nalbari Town Road, Nalbari - 3561 ward No. 5, Dist. Nalbari Assam, Nalbari, Assam, 781335",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Nalbari Town Road, Nalbari - 3561, ward No. 5, Dist. Nalbari, Assam, Nalbari, Assam, 781335"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "Baihata Chariali, Mangaldoi Road Baihati Chairali - 3562 Shanti Market Opp. Durga Mandir, Dist - Kamrup, Assam, Kamrup, Assam, 781381",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Baihata Chariali, Mangaldoi Road, Baihati Chairali - 3562 Shanti Market Opp. Durga Mandir, , Dist - Kamrup, Assam, Kamrup, Assam, 781381"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "Hospital Road NR Tokani circle, Golaghat - 3563 Ward no-4, Golaghat Assam , Golaghat, Assam, 785621",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Hospital Road NR Tokani circle, Golaghat - 3563, Ward no-4, Golaghat Assam, , Golaghat, Assam, 785621"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "M.G. Road , MG Road - Jorhat - 3564, Opp Old Public Bus Stand Jorhat, Jorhat, Assam, 785001",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "M.G. Road , MG Road - Jorhat - 3564, Opp Old Public Bus Stand Jorhat, Jorhat, Assam, 785001"
},
{
"businessNature": "Retail Business, Others, Supplier of Services, Recipient of Goods or Services",
"detailedAddress": "Ground and First Floor, Kenduguri Jorhat - 3565 Kenduguri Tiniali Junction, Charigaon Jorhat, Jorhat, Assam, 785010",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Ground and First Floor, Kenduguri Jorhat - 3565, Kenduguri Tiniali Junction, Charigaon, Jorhat, Jorhat, Assam, 785010"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "Raha Natun Charaili, Raha - 3566 Near-Hussain Hardware, Nagaon Nagaon, Assam, 782103",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Raha Natun Charaili, Raha - 3566, Near-Hussain Hardware, Nagaon, Nagaon, Assam, 782103"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "Ward no-5, Titabor Chairali Titabor - 3567 Opp. Titabor Medical Store, Dist- Jorhat, , Jorhat, Assam, 785630",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Ward no-5, Titabor Chairali, Titabor - 3567 Opp. Titabor Medical Store, , Dist- Jorhat, , Jorhat, Assam, 785630"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "House No -196, Pathsala - 3568 Station roadPathsala, NR SBI branch Dist Barpeta, Barpeta, Assam, 781325",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "House No -196, Pathsala - 3568, Station roadPathsala, NR SBI branch Dist, Barpeta, Barpeta, Assam, 781325"
},
{
"businessNature": "Retail Business, Others, Recipient of Goods or Services, Supplier of Services",
"detailedAddress": "Baroda Lane, Hospital Road Silchar - 3622 , Ambicapatty Point Silchar, Cachar, Assam, 788001",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "Baroda Lane, Hospital Road, Silchar - 3622 , Ambicapatty Point, Silchar, Cachar, Assam, 788001"
}
],
"primaryBusinessAddress": {
"businessNature": "Retail Business, Supplier of Services, Recipient of Goods or Services, Office / Sale Office, Others",
"detailedAddress": "First Floor, Prithivi Mansion 3512-DISPUR G.S. Road Lachit Nagar, opp. KFC building Kamrup, Assam, 781007",
"email": "[email protected]",
"lastUpdatedDate": "NA",
"mobileNo": 9999999999,
"registeredAddress": "First Floor, Prithivi Mansion 3512-DISPUR, G.S. Road Lachit Nagar, opp. KFC building, Kamrup, Assam, 781007"
},
"registerCancellationDate": "",
"registerDate": "30/09/2017",
"stateJurisdiction": "State - Assam,Zone - Guwahati Zone-A,Unit - Guwahati-A,Circle - GUWAHATI - A - 1",
"taxPayerType": "Regular",
"tradeName": "UJJIVAN SMALL FINANCE BANK LIMITED",
"grossTotalIncome": "Not Available",
"grossTotalIncomeFinancialYear": "2019-2020"
},
"pool": {
"referenceId": "1231003155432GXSUV",
"openingBalance": "98183.70",
"paymentAmount": "0.00",
"mode": "DR",
"closingBalance": "98183.70"
}
},
"timestamp": "2023-10-03 15:54:32",
"ipay_uuid": "h0009a47bac8-ef48-4735-81ee-bff727037999-tLsgSaCua6Xz",
"orderid": "1231003155432GXSUV",
"environment": "SANDBOX",
"internalCode": null
}