| Description: The GSTIN Verification API enables seamless validation of GSTINs, ensuring the accuracy of GST-related records. It provides real-time monitoring of GST filing history, helping businesses maintain compliance. |
Headers
| Content-Type: application/JSON |
| header_secrets: To be shared during integration by ISU Team |
| pass_key: To be shared during integration by ISU Team |
Request Body Parameters
| Parameters | Parameter description with validations and examples | Data type | Mandatory/Optional |
| gstNo | A unique 15-digit identification number. Itmust Not be NULL. E.g. - "33GSPTN7041G1Z8" | String | Mandatory |
Sample Request Body
Encrypted Sample Request Body
Response Body Parameters (Success)
| Parameters | Parameter description with examples | Data type |
| status | Status of the operation 0 | String |
| message | Status Operation message E.g.- "Data fetch successfully" | String |
| result | contains the verified details of the taxpayer or business entity | Object |
| GSTINID | GST id no. E.g.- "33GSPTN7041G1Z8" | String |
| RegistrationDate | Date of Registration E.g.- "15/04/2021" | String |
| TypeOfCompany | Company types E.g.- "Proprietorship" | String |
| StatusOfCompany | Company Status E.g.- "Active" | String |
| NameOfCompany | Company Name E.g.- "PRASANTA MOHAPATRA" | String |
| StateOfCompany | Company State E.g.- "Bhubaneswar I Circle" | String |
| Status | Status of the GST registration E.g.- "S" | String |
| Reason | Provide the reason for any status change | Integer |
| TaxPayerType | The category of taxpayer E.g.- "Regular" | String |
| CentreJurisdiction | Jurisdiction Centre E.g.- "BHUBANESWAR VII RANGE" | String |
| StateJurisdiction | Jurisdiction state E.g.- "Bhubaneswar I Circle" | String |
| NatureOfBusinessActivity | Nature Of Business Activity E.g.- "[\"Retail Business\"]" | String |
| DateOfCancellation | Cancel date | String |
| LastUpdatedDate | Update last date E.g.- "15/04/2021" | String |
| StateJurisdictionCode | unique code of state GST jurisdiction E.g.- "OD007" | String |
| CentreJurisdictionCode | unique code of central GST jurisdiction E.g.- "WJ0107" | String |
| PrincipalAddress | Main place of business associated with the GSTIN | Object |
| Address | Registered business location details associated with the GSTIN | Object |
| BuildingName | Name of the building E.g.- "Sailashree Bihar" | String |
| Street | Name of the Street E.g.- "Infocity" | String |
| Location | Name of the area E.g.- "BHUBANESWAR" | String |
| BuildingNo | Specific no. of the building E.g.- "PLOT NO-1918/4265" | String |
| District | where business are located E.g.- "Khordha" | String |
| StateCode | A unique code of the state E.g.- "Odisha" | String |
| City | Name of city | String |
| FloorNo | Floor number of the building E.g.- "LANE NO-3" | String |
| lattitude | Geographical latitude of the business location | String |
| PinCode | Postal code E.g.- "751024" | String |
| longitude | Geographical longitude of the business location | String |
| NaturePlaceOfBusiness | The classification of the business place E.g.- "Retail Business" | String |
| AdditonalAddress | Supplementary address | String |
| ConstitutionOfBusiness | The legal structure of the business E.g.- "Proprietorship" | String |
| TradeName | Trade purposes name E.g.- "ANSHUMAN PHARMACEUTICALS" | String |
Response Body Parameters (Failed)
| Parameters | Parameter description with examples | Data type |
| status | Status of the operation here it is FAILED | String |
| statusCode | Status Code of the Operation.Here it is 1 that signifies a Failed Response. | String |
| message | Status Operation message E.g -"Please Enter Valid GST Number" | String |
Sample Response Body
Success :
Sample Response Body (FAILED)
Missing GST Number:
Invalid GST Number:
Encrypted Sample Response Body
Detailed Status Codes
| Status | Status Description | Message |
| 0 | SUCCESS | Data fetch successfully |
| 1 | FAILED |
|
