Extend Validity

post

https://api.in.onefinops.com/v1/ewaybills/extend

Extend the validity of an active EWB. NIC business rule: extend window is only the last 8 hours of validity — calling earlier returns can only extend within 8h of validity. NIC computes the extension period from remaining distance and consignment status; callers do not specify hours directly. The EWB to extend is supplied in the request body as ewbNumber (not in the URL).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

ewbNumber

int64

required

12-digit EWB number to extend.

vehicleNumber

string

required

fromPlace

string

required

fromStateCode

integer

required

fromPincode

integer

required

reasonCode

integer

enum

required

Reason for extending validity. Required.

1 — Natural Calamity (flood, cyclone, earthquake)
2 — Law & Order (curfew, riot, road closure)
4 — Transhipment (transferred to another vehicle / hub)
5 — Accident
99 — Others (free-text remark recommended)

Allowed:

remark

string | null

consignmentStatus

string

enum

required

Consignment status at time of extension. Required.

M — In Movement (vehicle still en route)
T — In Transit (parked / warehoused; carries the
warehouse address in addressLine1/2/3)

Allowed:

transitType

string | null

enum

Where the consignment is parked. Required only when
consignmentStatus is T.

R — Road (parked roadside)
W — Warehouse
O — Others

Allowed:

remainingDistanceKm

integer

required

transportDocumentNumber

string | null

transportDocumentDate

date | null

transportMode

integer

enum

required

1=Road, 2=Rail, 3=Air, 4=Ship, 5=In Transit (extend-only).

Allowed:

addressLine1

string | null

addressLine2

string | null

addressLine3

string | null

Headers

gstin

string

required

length between 15 and 15

^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z][A-Z0-9]{3}$

GSTIN whose NIC IRP / EWB-portal credential authorizes the call.
Seed each GSTIN's credential through the Developer Console.

X-Request-Id

uuid

Optional client-supplied UUID for correlation across logs and dashboards. If omitted, OneFinOps mints one and echoes it back on the response.

Responses

200Updated EWB record with extended validity.

409State conflict — see code for the specific reason.