Verify GSTIN

Use this API to verify if a given GSTIN information exists or not. View the test data and use the information to trigger the validations. The test data are usable only in the test environments such as gamma and sandbox.

Response Codes

Sub CodeStatusMessageNext Action
200SUCCESSGSTIN Doesn’t ExistEnter the correct information in the request.
400ERRORGSTIN first 2 digits should be numeric and length should not exceed 15 and should be alphanumeric.Enter a valid GSTIN in the request. The correct identifier has the first 2 digits in numerics and does not exceed 15 charaters.
400ERRORGSTIN is missing in the request.Enter the GSTIN information in the request.
400ERRORbusinessName can include a maximum of 200 characters.The maximum character limit for businessName is 200.
400ERRORbusinessName should be alphanumeric.Enter only alphabets and/or numerical values in the parameter.
400ERRORGstIn Verification is not enabled for this accountContact your account manager.
400ERRORClient secret belongs to test environmentEnter the correct environment credentials in the request.
400ERRORx-client-id is missing in the request.Enter all the header information in the API request.
401ERRORInvalid clientId and clientSecret combinationEnsure you enter valid x-client-id and x-client-secret information in the API request.
403ERRORIP not whitelisted your current ip is IP whitelisting assistance, visit our guide at the IP address.
422ERRORInsufficient balance to process this requestTry again with sufficient balance.
500ERRORUnable to validate, please retry laterTry again after some time.
Click Try It! to start a request and see the response here!