Extend E-Way Bill Validity

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: <api-key>' \
  --header 'x-api-key: <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"
}
'

{
  "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"
}

POST

gst

compliance

e-way-bill

consignor

bill

{ewb_no}

extend

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: <api-key>' \
  --header 'x-api-key: <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"
}
'

{
  "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"
}

NIC validations

View NIC validations

To distinguish between the goods either on Road or in transit, new parameter transitType ( R- Road, W - Warehouse, O-Others) are introduced for Extend E-waybill API.
If transmode is 1 to 4 then consignmentStatus value should be M and transitType should be blank (“transitType”:"").
If transmode is 5 then consignmentStatus value should be T and transitType value can be either R or W or O.
The Validity of EWB can be extended only by the current transporter. If transporter is not assigned, then the generator can update.
The validity of EWB can be extended between 8 hours before expiry time and 8 hours after expiry time.
The reason code along with reason description for the extension has to be entered.
The present location of the consignment, at the time of requesting for the extension, has to be entered and distance to travel from there to destination has to be entered.
If vehicle number is passed, the format of the vehicle number should be valid and as per the format
In case of road as a transportation mode , the vehicle number should be passed and transport document number is optional.
In case of rail, air or ship as a transportation mode, the transport document number is must.
Remaining distance should not be more than the actual distance mentioned during the generation of E-way bill.
Railways integration for validating Trans Document NO .
Restriction of extension of E Way Bills beyond 360 days of generation of E Way Bill .

Request body schema

View request body schema

Authorizations

authorization

string

header

required

E-Way Bill taxpayer access token returned by Authenticate.

x-api-key

string

header

required

Sandbox API key from your Sandbox account.

Headers

x-api-version

string

default:1.0.0

API version

x-source

enum<string>

default:primary

NIC server for the session used by this request. primary selects NIC1. secondary selects NIC2. Defaults to primary. See NIC1 and NIC2 routing.

Available options:

primary,

secondary

x-proxy

enum<string>

NIC server that receives the request. If omitted, the request goes to the server selected by x-source. When specified, selects the other server. See NIC1 and NIC2 routing.

Available options:

primary,

secondary

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

See transport modes.

extnRsnCode

number

required

Extension Reason Code

See validity-extension reasons and consignment status.

extnRemarks

string

required

Extension Remarks

fromPincode

number

required

From Pincode

vehicleNo

string

Vehicle Number

See vehicle number formats.

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)

See validity-extension reasons and consignment status.

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

Analytics

Compliance

Annexures

Extend E-Way Bill Validity

NIC validations

Request body schema

View request body schema

Authorizations

Headers

Path Parameters

Body

Response

​NIC validations

​Request body schema

View request body schema

Authorizations

Headers

Path Parameters

Body

Response

NIC validations

Request body schema