Skip to main content
POST
/
gst
/
compliance
/
e-way-bill
/
consignor
/
bill
/
{ewb_no}
/
cancel
curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/e-way-bill/consignor/bill/{ewb_no}/cancel \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "ewbNo": 291010077005,
  "cancelRsnCode": 2,
  "cancelRmrk": "Cancelled the order"
}
'
{
  "code": 200,
  "data": {
    "alert": null,
    "data": {
      "cancelDate": "01/05/2024 07:56:00 PM",
      "ewayBillNo": "291010077005"
    },
    "status": "1"
  },
  "timestamp": 1763446641000,
  "transaction_id": "e7da707c-76c2-4c7e-afb7-a9997d9ab5d3"
}

ā€‹
Request body schema

View request body schema

šŸ“˜ Only the generator can cancel the E-Way Bill.
šŸš§ The bill can be only cancelled within 24 hrs of generation.

Headers

ā€‹
authorization
string
required

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

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

API version

ā€‹
x-api-key
string
required

API key for identification

Path Parameters

ā€‹
ewb_no
string
required

Body

application/json
ā€‹
ewbNo
number<double>
required

E-Way Bill number

ā€‹
cancelRsnCode
integer<int32>
required

Reason for cancellation. Possible values: 1 (Duplicate), 2 (Order Cancelled), 3 (Data Entry mistake), 4 (Others)

ā€‹
cancelRmrk
string

Remarks

Response

200 - application/json

200 EWB cancelled / 312 EWB already cancelled/receiver cannot cancel EWB / 444 EWB cannot be cancelled as it is generated from NIC1

ā€‹
code
number
Example:

200

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

1763446641000

ā€‹
transaction_id
string
Example:

"e7da707c-76c2-4c7e-afb7-a9997d9ab5d3"