GST GSP API Reference

Environments

ClearTax GST GSP has 2 environments:
  1. 1.
    Sandbox Environment
  2. 2.
    Production Environment

1. Sandbox Environment

For testing, it is recommended to always use the sandbox environment. To create an account, contact our sales representative with the following information:
  1. 1.
    Company Name
  2. 2.
    Company Address
  3. 3.
    Company Website address
  4. 4.
    Authorized Signatory Name
  5. 5.
    Contact Email ID
  6. 6.
    Contact Mobile No
  7. 7.
    PAN No
  8. 8.
    Aadhaar No
  9. 9.
    Type of user (Choose one of Normal Taxpayer, Composite User, TCS User, TDS User, ISD User)
  1. 1.
    All the fields mentioned above are mandatory.
  2. 2.
    The OTP will be sent to the contact details given above. Hence, please provide these details accordingly.
  3. 3.
    Please ensure that a valid DSC is available against the PAN given above. Otherwise, the filing of GSTR will not be possible.
  4. 4.
    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.

1.1 API URLs to be used/whitelisted

For API requests to the sandbox environment, use the below information.
API Type
Hostname
IP
GST GSP
https://api-sandbox.clear.in
75.2.104.91 AND 99.83.130.139
For implementations done prior to 1st May 2022, the following hostname is used and listed here for reference only.
API Type
Hostname
IP
GST GSP
https://sandbox.gsp.cleartax.in/
Not available
Port: 443

1.2 SSL/TLS Certificate to be downloaded and installed

For detailed information on how to download the host, intermediate, and root certificates, you can always refer to How to get SSL Certificate. Alternatively, you can also download the certificates directly from the below links.
API Type
Certificate(s)
GST GSP
wildcard.clear.in.cer
go-daddy-intermediate.cer
go-daddy-root.cer
For implementations done prior to 1st May 2022, the following SSL certificates may be required and are listed here for reference only.
API Type
Certificate(s)
GST GSP
wildcard.gsp.cleartax.in.cer
rapidssl_intermediate_2022.cer
digicert_root.cer

GSTN server public key

You can download the latest public key of GSTN for the sandbox environment from https://developer.gst.gov.in/apiportal/howToStart/download

2. Production Environment

Once you have completed testing, you can move to production. To create an account, contact our sales representative with the following information:
  1. 1.
    Company Name
  2. 2.
    Contact Name
  3. 3.
    Contact Email
  4. 4.
    Contact Phone

2.1 API URLs to be used/whitelisted

For API requests to the production environment, use the below information.
API Type
Hostname
IP
GST GSP
https://api.clear.in
13.248.191.113 AND 76.223.59.133
For implementations done prior to 1st May 2022, the following hostname is used and listed here for reference only.
API Type
Hostname
IP
GST GSP
https://gsp.cleartax.in/
Not available
Port: 443

2.2 SSL/TLS Certificate to be downloaded and installed

For detailed information on how to download the host, intermediate, and root certificates, you can always refer to How to get SSL Certificate. Alternatively, you can also download the certificates directly from the below links.
API Type
Certificate(s)
GST GSP
wildcard.clear.in.cer
go-daddy-intermediate.cer
go-daddy-root.cer
For implementations done prior to 1st May 2022, the following SSL certificates may be required and are listed here for reference only.
API Type
Certificate(s)
GST GSP
wildcard.gsp.cleartax.in.cer
rapidssl_intermediate_2022.cer
digicert_root.cer

GSTN server public key

You can download the latest public key of GSTN for the production environment from https://developer.gst.gov.in/apiportal/howToStart/download