Sample API

Base URL



All requests require the user authentication token in the request header.


To generate authentication token, please contact ClearTax GST Sales.

For all new users, you DO NOT have to add client-id and client-secret to the request headers.

For customers migrating from Karvy, please contact for your updated karvyclientid and karvyclient_secret.

Sample Request

curl --location --request POST '' \
--header 'Gstin: 07AAFCD5862R1ZX' \
--header 'X-CT-Auth-Token: 3c469428-5708-479e-a116-294fd57fe052' \
--header 'Content-Type: application/json' \
--data-raw '{

For further information on different endpoints like generate, cancel, extend, etc, please refer to the NIC documentation at

Error Codes

In case you have received an error code from NIC, you can check the description of the code here:

Last updated