GST Verification
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-07-03 10:50:19
GST registration details, taxpayer information, business constitution, jurisdiction, registration status, and registered address.
Request Headers
| Header | Description |
|---|---|
service-key | Unique service key provided for accessing the GST verification service |
Authorization | API authorization credentials for secure access |
providercode | Provider code assigned for GST service authentication |
Content-Type | Specifies the request payload format (application/json) |
Request Parameters
| Parameter | Type | Description |
|---|---|---|
gstin | String | 15-character GST Identification Number to be verified |
documentType | String | Specifies the verification type (gst verification) |
Response Fields
| Field | Description |
|---|---|
ok | Indicates whether the request was successful (true / false) |
message | Status message describing the verification result |
status | HTTP/application status code returned by the API |
result.gstin | Verified GST Identification Number |
result.registrationDate | Date on which the GST registration was issued |
result.companyName | Legal name of the registered business |
result.tradeName | Trade name of the business |
result.companyType | Type of registered business entity |
result.companyStatus | Current status of the GST registration |
result.taxpayerType | Category of taxpayer (e.g., Regular, Composition) |
result.constitutionOfBusiness | Constitution of the business entity |
result.stateOfCompany | State where the business is registered |
result.stateJurisdiction | GST state jurisdiction of the taxpayer |
result.centreJurisdiction | GST central jurisdiction of the taxpayer |
result.stateJurisdictionCode | Code representing the state GST jurisdiction |
result.centreJurisdictionCode | Code representing the central GST jurisdiction |
result.natureOfBusiness | Nature of business activities carried out by the taxpayer |
result.cancellationDate | Date of GST cancellation, if applicable |
result.lastUpdatedDate | Last date on which GST information was updated |
result.status | Current GST registration status code |
result.reason | Reason associated with the current GST status, if available |
result.principalAddress | Registered principal place of business including building, street, city, district, state, PIN code, latitude, longitude, and place of business |
result.additionalAddress | Additional registered place(s) of business, if available |
error | Contains error details if the request fails |
Use Cases
- GSTIN validation during customer and vendor onboarding
- Business identity verification and KYC
- Fraud detection and compliance checks
- Vendor due diligence and procurement validation
- Financial institution and lending verification
Key Benefits
- Real-time GSTIN verification from GSTN
- Comprehensive taxpayer and business information
- Supports regulatory compliance and due diligence
- Secure and scalable API integration
- Reduces manual verification efforts and fraud risk
Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.staging.indiconnect.in/idverifygr/verification' \
--header 'service-key: sk_test_bf78b31a4b9275ca' \
--header 'Authorization: x-api-access indc_test_8cdbb53b09f50c3c:ac_test_bd6e115254f11a58' \
--header 'providercode: LLOK77FI' \
--header 'Content-Type: application/json' \
--data '{
"query": "mutation { gstVerify(input: {documentType: \"gst verification\", gstin: \"33GSPTN7041G1Z8\"}) { ok message status result { gstin registrationDate companyName tradeName companyType companyStatus taxpayerType constitutionOfBusiness stateOfCompany stateJurisdiction centreJurisdiction stateJurisdictionCode centreJurisdictionCode natureOfBusiness cancellationDate lastUpdatedDate status reason principalAddress { Address { BuilingName Street Location BuildingNo District StateCode City FloorNo lattitude longitude PinCode NaturePlaceOfBusiness } } additionalAddress } error }}"
}'Response Response Example
{"data":{"gstVerify":{"ok":true,"message":"Verification completed successfully","status":200,"result":{"gstin":"33GSPTN7041G1Z8","registrationDate":"01/04/2016","companyName":"NSDL1 TN TaxPayer 1 Ltd","tradeName":"NSDL1 TN TaxPayer 1 Ltd","companyType":"Proprietorship","companyStatus":"Suspended","taxpayerType":"Regular","constitutionOfBusiness":"Proprietorship","stateOfCompany":"ADYAR","stateJurisdiction":"ADYAR","centreJurisdiction":null,"stateJurisdictionCode":"TN001","centreJurisdictionCode":"0101","natureOfBusiness":null,"cancellationDate":"29/09/2025","lastUpdatedDate":"29/09/2025","status":"S","reason":null,"principalAddress":{"Address":{"BuilingName":"","Street":"","Location":"","BuildingNo":"","District":"","StateCode":"","City":"","FloorNo":"","lattitude":"","longitude":"","PinCode":"","NaturePlaceOfBusiness":""}},"additionalAddress":null},"error":null}}}
Modified at 2026-07-03 10:50:19