Skip to main content
POST
/
gst
/
compliance
/
e-invoice
/
tax-payer
/
invoice
/
{irn}
/
cancel
curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/e-invoice/tax-payer/invoice/{irn}/cancel \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "Irn": "49a7c675b25f730d2353622e4767df203fed2495411953e0351737d47308d868",
  "CnlRsn": "1",
  "CnlRem": "Wrong entry"
}
'
{
  "code": 200,
  "data": {
    "Data": {
      "CancelDate": "2023-03-30 17:11:00",
      "Irn": "49a7c675b25f730d2353622e4767df203fed2495411953e0351737d47308d868"
    },
    "ErrorDetails": null,
    "InfoDtls": null,
    "Status": 1
  },
  "timestamp": 1763446641000,
  "transaction_id": "4b8e067e-eb06-42bb-bd23-3fe49f89a2a3"
}

ā€‹
Request body schema

View request body schema

Headers

ā€‹
authorization
string
required

E-Invoice access token. For token-generation steps, refer to the Generate E-Invoice Session recipe, then pass the token in the authorization header.

ā€‹
x-source
enum<string>
default:primary

Specifies the source to access, either primary (NIC 1) or secondary (NIC 2)

Available options:
primary,
secondary
Example:

"primary"

ā€‹
x-proxy
enum<string>

Enables criss-cross operations by routing requests through the specified source (e.g., access primary via secondary if primary is unavailable)

Available options:
primary,
secondary
Example:

"secondary"

ā€‹
x-api-version
string
default:1.0.0

API version

ā€‹
x-api-key
string
required

API key for identification

Path Parameters

ā€‹
irn
string
required

Body

application/json
ā€‹
Irn
string
required

IRN of E-Invoice to be cancelled

ā€‹
CnlRsn
string
required

Cancel Reason. Possible values: 1 - Duplicate, 2 - Data entry mistake, 3 - Order Cancelled, 4 - Others

ā€‹
CnlRem
string

Cancel Remarks

Response

200 - application/json

200 IRN cancelled / 9999 IRN is not active / 2270 More than 24 hrs old / 2230 IRN cannot be cancelled as EWB is active / 2143 IRN doesn't belong to user

ā€‹
code
number
Example:

200

ā€‹
data
object
ā€‹
timestamp
number
Example:

1763446641000

ā€‹
transaction_id
string
Example:

"4b8e067e-eb06-42bb-bd23-3fe49f89a2a3"