Extend E-Way Bill Validity

With this API, businesses can extend validity of the E-Way Bill. You can extend an E-Way Bill up to eight hours before or after it expires. The validity extension will be based on the remaining distance to be traveled.

POST /gst/compliance/e-way-bill/consignor/bill/{ewb_no}/extend

cURL

200 Success

curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/e-way-bill/consignor/bill/{ewb_no}/extend \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "ewbNo": 291210077217,
  "vehicleNo": "PQR1234",
  "fromPlace": "Bengaluru",
  "fromState": 29,
  "remainingDistance": 50,
  "transDocNo": "1234",
  "transMode": "5",
  "extnRsnCode": 1,
  "extnRemarks": "Flood",
  "fromPincode": 560090,
  "consignmentStatus": "T",
  "transitType": "R",
  "addressLine1": "Bengaluru",
  "addressLine2": "Bengaluru",
  "addressLine3": "Bengaluru"
}
'

200

200 Success

{
  "code": 200,
  "data": {
    "alert": null,
    "data": {
      "ewayBillNo": "291210077217",
      "updatedDate": "26/04/2024 05:07:00 PM",
      "validUpto": "21/05/2024 23:59:00 PM"
    },
    "status": "1"
  },
  "timestamp": 1763446641000,
  "transaction_id": "e4bbb27c-f1b5-4b07-9396-4d3fa3a217b3"
}

Request body schema

View request body schema

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

E-Way Bill schema.

ewbNo · number · required

Ewaybill Number

fromPlace · string · required

From Place

Maximum string length: 50

fromState · integer · required

From State

Required range: x <= 99

remainingDistance · number · required

Remaining Distance

transMode · string · required

Transport Mode

extnRsnCode · number · required

Extension Reason Code

extnRemarks · string · required

Extension Remarks

fromPincode · number · required

From Pincode

vehicleNo · string

Vehicle Number

Required string length: 7 - 15

transDocNo · string

Transport Document Number

Maximum string length: 15

transDocDate · string

Transport Document Date

Pattern: [0-3][0-9]/[0-1][0-9]/[2][0][1-2][0-9]

consignmentStatus · string

consignmentStatus(T)

transitType · string

transit Type

addressLine1 · string

addressLine1

addressLine2 · string

addressLine2

addressLine3 · string

addressLine3

Response

200 - application/json

200 Success / 382 Validity can be only extended in last 8 hours / 705 Invalid transit type

Option 1

Option 2

An E-Way Bill success or NIC business-failure response. Both variants use HTTP 200.

code · enum<integer> · required

NIC response code.

Available options: 200

timestamp · integer<int64> · required

Unix timestamp.

transaction_id · string · required

Request transaction identifier.

data · object · required

Show child attributes