| 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 |
| client_id: will be provided later |
| client_secret: will be provided later |
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. - "21CLZPM4084Q1Z4 | String | Mandatory |
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 | ||
| GSTINID | GST id no. E.g.- “21CLZPM4084Q1Z4” | 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 KUMAR MOHAPATRA" | String |
| StateOfCompany | Company State E.g.- "Bhubaneswar I Circle" | String |
| Status | Status of the GST registration E.g.- "Suspended" | String |
| Reason | Provide the reason for any status change | Integer |
| TaxPayerType | The category of taxpayer E.g.- "Regular" | String |
| CentreJurisdiction | Company Status E.g.- "Active" | String |
| StateJurisdiction | Company Status E.g.- "Active" | String |
| NatureOfBusinessActivity | Company Status E.g.- "Active" | 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 | ||
| Address | General address | String |
| BuildingName | Name of the building E.g.- "SRIRAM NAGAR" | String |
| Street | Name of the Street E.g.- "OLD TOWN" | String |
| Location | Name of the area E.g.- "BHUBANESWAR" | String |
| BuildingNo | Specific no. of the building E.g.- "PLOT NO-1918/4265/4309" | 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 E.g.- | String |
| FloorNo | Floor number of the building E.g.- "LANE NO-3" | String |
| lattitude | Geographical latitude of the business location E.g.- | String |
| PinCode | Postal code E.g.- "751002" | String |
| longitude | Geographical longitude of the business location E.g.- | String |
| NaturePlaceOfBusiness | The classification of the business place E.g.- "Retail Business" | String |
| AdditonalAddress | Supplementary address “Null” | 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:
Detailed Status Codes
| Status | Status Description | Message |
| 0 | SUCCESS | Data fetch successfully |
| 1 | FAILED |
|
