Initiate multi-vehicle movement

post

https://api.in.onefinops.com/v1/ewaybills/multivehicle/initiate

Declare that an existing EWB's cargo is being split across multiple vehicles. NIC returns a group number that ties the subsequent add/change calls together. ewbNumber is carried in the body so the URL stays path-param-free. Caller-acting GSTIN in the gstin header.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

ewbNumber

int64

required

The EWB whose cargo is being split across multiple vehicles.
Carried in the body so the URL stays path-param-free.

reasonCode

string

required

Reason for splitting cargo across multiple vehicles.

reasonRemark

string | null

fromPlace

string

required

fromStateCode

integer

required

1 to 37

toPlace

string

required

toStateCode

integer

required

1 to 37

transportMode

string

enum

required

1=Road, 2=Rail, 3=Air, 4=Ship.

Allowed:

totalQuantity

number

required

Must not exceed the quantity on the parent EWB for the first initiation.

unitCode

string

required

UQC unit code (e.g. NOS, BAG, KGS).

Headers

gstin

string

required

length between 15 and 15

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

400

Bad request.

401

Missing or invalid OAuth token.

404

Resource not found.

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success