post https://sandbox.cashfree.com/verification/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 Code | Status | Message | Next Action |
|---|---|---|---|
| 200 | SUCCESS | GSTIN Exists | - |
| 200 | SUCCESS | GSTIN Doesn’t Exist | Enter the correct information in the request. |
| 400 | ERROR | GSTIN 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. |
| 400 | ERROR | GSTIN is missing in the request. | Enter the GSTIN information in the request. |
| 400 | ERROR | businessName can include a maximum of 200 characters. | The maximum character limit for businessName is 200. |
| 400 | ERROR | businessName should be alphanumeric. | Enter only alphabets and/or numerical values in the parameter. |
| 400 | ERROR | GstIn Verification is not enabled for this account | Contact your account manager. |
| 400 | ERROR | Client secret belongs to test environment | Enter the correct environment credentials in the request. |
| 400 | ERROR | x-client-id is missing in the request. | Enter all the header information in the API request. |
| 401 | ERROR | Invalid clientId and clientSecret combination | Ensure you enter valid x-client-id and x-client-secret information in the API request. |
| 403 | ERROR | IP not whitelisted your current ip is 106.51.91.104.For IP whitelisting assistance, visit our guide at https://docs.cashfree.com/docs/ip-whitelisting-verification | Whitelist the IP address. |
| 422 | ERROR | Insufficient balance to process this request | Try again with sufficient balance. |
| 500 | ERROR | Unable to validate, please retry later | Try again after some time. |