E-Invoicing API Reference

Environments

ClearTax E-Invoicing 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.
For API requests to the sandbox environment, use the below information.

1.1 API URLs to be used/whitelisted

For API requests to the sandbox environment, use the below information.
API Type
Hostname
IP
E-Invoicing
https://api-sandbox.clear.in
75.2.104.91 AND 99.83.130.139
Please note that the above URL is for API requests only. The corresponding frontend web application URL where you can log in and verify the data is https://einv-sandbox.cleartax.in
Port: 443
TLS Versions Supported: TLS 1.2, TLS 1.1, and TLS 1.0.

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)
E-Invoicing
wildcard.clear.in.cer
go-daddy-intermediate.cer
go-daddy-root.cer
The following SSL certificates are supported for backward compatibility with the old hostname (https://einvoicing.internal.cleartax.co). In case you are implementing it for the first time, ignore the below certificates.
API Type
Certificate(s)
E-Invoicing
wildcard.internal.cleartax.co.cer
amazon intermediate.cer
amazon root.cer

2. Production Environment

2.1 API URLs to be used/whitelisted

For API requests to the production environment, use the below information.
API Type
Hostname
IP
E-Invoicing
https://api.clear.in
13.248.191.113 AND 76.223.59.133
For implementations done prior to 1st May 2022, the following additional hostnames will have to be whitelisted.
API Type
Hostname
IP
E-Invoicing
https://api-einv.cleartax.in
76.223.59.133 AND 13.248.191.113
Please note that the above URL is for API requests only. The corresponding frontend web application URL where you can log in and verify the data is https://einv.cleartax.in/
Port: 443
TLS Versions Supported: TLS 1.2, TLS 1.1, and TLS 1.0.

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.
For hostname
Certificate(s)
api.clear.in
wildcard.clear.in.cer
go-daddy-intermediate.cer
go-daddy-root.cer
For implementations done prior to 1st May 2022, where the hostname is api-einv.cleartax.in, the following SSL certificates may be required and are listed here for reference only.
For hostname
Certificate(s)
api-einv.cleartax.in (before 3rd August 2022)
api-einv.cleartax.in.cer
rapidssl_tls_dv_rsa_mixed.cer
DigiCert.cer
api-einv.cleartax.in (from 3rd August 2022)
api-einv.cleartax.in.cer
rapidssl_intermediate.cer
digicert_root.cer

Different sets of E-Invoicing API

ClearTax E-Invoicing provides 2 kinds of APIs:
  1. 1.
    Government Compatible APIs
  2. 2.
    ClearTax E-Invoicing APIs
These are synchronous APIs that cater to basic e-invoicing functionalities and the schema is compatible with the schema provided by the government.
  • Generate IRN
  • Cancel IRN
  • Get Invoice by IRN
These APIs are available for consumption in the staging environment.

Difference between ClearTax API and Government Compatible API

Actions
Government Compatible API
ClearTax API
Generating IRN
Y
Y
Ability to send Custom fields
N
Y
Retry IRN Generation (for invoices failed due to IRP failures)
N
Y
Invoice Validation
Y
Y
Generating IRN (Bulk)
N
Y
Canceling IRN
Y
Y
Getting IRN details
Y
Y
Printing E-invoice
Y
Y

Copy link
Outline
Environments
1. Sandbox Environment
1.1 API URLs to be used/whitelisted
1.2 SSL/TLS Certificate to be downloaded and installed
2. Production Environment
2.1 API URLs to be used/whitelisted
2.2 SSL/TLS Certificate to be downloaded and installed
Different sets of E-Invoicing API
Difference between ClearTax API and Government Compatible API