> For the complete documentation index, see [llms.txt](https://docs.cleartax.in/cleartax-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cleartax.in/cleartax-docs/e-invoicing-api/e-invoicing-api-reference/rcm-self-invoicing-purchase-documents-clear-schema/cancel-irn.md).

# Cancel IRN

### Request Method

#### PUT

### Request URL

```
{{HOST}}/einv/v2/eInvoice/cancel
```

#### Request Headers

<table><thead><tr><th>PARAMETER</th><th width="214">PARAMTER TYPE</th><th width="150">TYPE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>X-Cleartax-Auth-Token</td><td>Header</td><td>String</td><td>Mandatory. The auth token generated from ClearTax user id and password. <a href="https://docs.cleartax.in/cleartax-for-developers/e-invoicing-api/e-invoicing-api-reference/authentication-token">Know how.</a></td></tr><tr><td>Content-Type</td><td>Header</td><td>String</td><td>Mandatory. This will always be <br>"application/json" for JSON </td></tr><tr><td>gstin</td><td>Header</td><td>String</td><td>Mandatory. GSTIN number for the user</td></tr><tr><td>invoiceType</td><td>Header</td><td>String</td><td>PURCHASE </td></tr></tbody></table>

### Sample Request and Response

#### Request&#x20;

```json
[
  {
    "irn": "94b6c41efd740424c469908d0927db66d8f24d9dad78b02dab04ad1659813dc9",
    "CnlRsn": "1",
    "CnlRem": "Wrong"
  }
]

```

#### Response

```json
[
  {
    "custom_fields": null,
    "deleted": false,
    "document_status": "IRN_CANCELLED",
    "error_response": null,
    "errors": null,
    "govt_response": {
      "Success": "Y",
      "AckNo": 112310153714784,
      "AckDt": "2027-01-02 13:38:00",
      "Irn": "94b6c41efd740424c469908d0927db66d8f24d9dad78b02dab04ad1659813dc9",
      "SignedInvoice": "eyJhbGciOiJSUzI1NiIsImt......",
      "SignedQRCode": "eyJhbGciOiJSUzI1NiIsImt......",
      "Status": "ACT",
      "CancelDate": "2027-01-02 15:10:00"
    },
    "group_id": null,
    "gstin": "29AWGPV7107B1Z1",
    "is_deleted": false,
    "owner_id": null,
    "tag_identifier": null,
    "transaction": { ... },          // the cancelled self-invoice
    "transaction_id": "29AWGPV7107B1Z1_SI/2026/001_INV_2026",
    "transaction_metadata": null
  }
]

```
