GST GSP API Reference
ClearTax GST GSP has 2 environments:
Sandbox Environment
Production Environment
For testing, it is recommended to always use the sandbox environment. To create an account, contact our sales representative with the following information:
Company Name
Company Address
Company Website address
Authorized Signatory Name
Contact Email ID
Contact Mobile No
PAN No
Aadhaar No
Type of user (Choose one of Normal Taxpayer, Composite User, TCS User, TDS User, ISD User)
All the fields mentioned above are mandatory.
The OTP will be sent to the contact details given above. Hence, please provide these details accordingly.
Please ensure that valid DSC is available against the PAN given above. Otherwise, the filing of GSTR will not be possible.
Aadhaar will be used for eSigning the GSTR.
Once a request for sandbox GSTIN credential creation is placed, GSTN processes the request fortnightly. So if you have applied on 1st Feb, you should expect credentials by 15th Feb.
Host:
https://gsp-sandbox.internal.cleartax.co/
Port: 443
IP: ClearTax does not use static IP for APIs. You can whitelist the endpoints based on the host.
SSL Certificate:
Our root Certifying Authority is "Amazon Root CA 1". You can get the CER or PEM file directly from Amazon's website here: https://www.amazontrust.com/repository/ or download it here.
In case you want to add the SSL certificate of our sandbox host to your trust manager, you can download it here.
You can download the latest public key of GSTN for sandbox environment from https://developer.gst.gov.in/apiportal/howToStart/download​
Once you have completed testing, you can move to production. To create an account, contact our sales representative with the following information:
Company Name
Contact Name
Contact Email
Contact Phone
For API requests to the production environment, use the below information.
Host:
https://gsp.cleartax.in/
Port: 443
IP: ClearTax does not use static IP for APIs. You can whitelist the endpoints based on the host.
SSL Certificate:
Our root Certifying Authority is "Amazon Root CA 1". You can get the CER or PEM file directly from Amazon's website here: https://www.amazontrust.com/repository/ or download it here.
In case you want to add the SSL certificate of our production host to your trust manager, you can download it here.
You can download the latest public key of GSTN for production environment from https://developer.gst.gov.in/apiportal/howToStart/download​
All requests require the user authentication token in the request header.
X-CT-Auth-Token: <YOUR-AUTH-TOKEN-HERE>
To generate an authentication token, please contact ClearTax GST Sales.
For all new users, you DO NOT have to add clientid and client-secret to the request headers.
For customers migrating from Karvy, please contact [email protected] for your updated karvyclientid and karvyclient_secret.
curl --location --request POST 'https://gsp.cleartax.in/api/taxpayerapi/v0.2/authenticate' \--header 'Content-Type: application/json' \--header 'appkey: 48Kw7zR3L9nsbBJI3BJBmg8K0cx/XoGzR6uJaksufhaksfochguhJk1DTvvHYQqQwaU0yhOqfZHgalD9sGMikaEBmY7Y1YcjP5drvwhmmcqQmCLK3D1FE18ditvlqV4DWou5feLM07QwWTj/i8mDwc5YgWz0cYnr6r7wnd2nlbmMxdHOYbKjOP6SxOdD2Gb6GZDI5+RFkkfGSPKwtvXR9NfZQaLaTIY1w8O0X0NI56C9oqjcqT5+FgdpTnLYc3rodHJuEFVgqfeTpWSk3QfAcnQg9P1N9Azcx2OI+AXbLLhcLLbSpfveelhaK02uEdUDYgGHfztr//9RPfqOzg==' \--header 'X-CT-Auth-Token: a2ceb341-asf12-1234-a54f-59d934acasaa' \--header 'state-cd: 33' \--header 'ip-usr: 123.456.789.100' \--header 'txn: txn123' \--header 'gstin: gstinNumber' \--header 'username: username' \--data-raw '{"action":"OTPREQUEST","app_key":"48Kw7zR3L9nsbBJI3BJBmg8K0cx/XoGzR6uJaksufhaksfochguhJk1DTvvHYQqQwaU0yhOqfZHgalD9sGMikaEBmY7Y1YcjP5drvwhmmcqQmCLK3D1FE18ditvlqV4DWou5feLM07QwWTj/i8mDwc5YgWz0cYnr6r7wnd2nlbmMxdHOYbKjOP6SxOdD2Gb6GZDI5+RFkkfGSPKwtvXR9NfZQaLaTIY1w8O0X0NI56C9oqjcqT5+FgdpTnLYc3rodHJuEFVgqfeTpWSk3QfAcnQg9P1N9Azcx2OI+AXbLLhcLLbSpfveelhaK02uEdUDYgGHfztr//9RPfqOzg==","username":"yourusername"}'
For further information on different endpoints like returns, ledger, payment, etc, please refer to the GSTN documentation at https://developer.gst.gov.in/apiportal/​
In case you have received an error code from GSTN, you can check the description of the code in the respective API page here: https://developer.gst.gov.in/apiportal/​