GST Verification

The GST Verification API enables businesses to validate Goods and Services Tax Identification Numbers (GSTINs) and retrieve comprehensive GST registration details directly from the GST Network (GSTN). Powered by an authorized GST Suvidha Provider (GSP), the API ensures secure, reliable, and real-time access to GST records.

It is designed to support GST compliance, customer onboarding, vendor verification, fraud prevention, and regulatory due diligence. By integrating this API, businesses can verify the authenticity and status of GST registrations before conducting transactions.

The API uses a GraphQL mutation request sent through an HTTP POST method and returns structured data containing
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

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 }}" }'

{ "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 } } }

Request Headers#

Request Parameters#

Response Fields#

Use Cases#

Key Benefits#

Request

Responses

Request Headers

Request Parameters

Response Fields

Use Cases

Key Benefits