Get E-Way Bill Details

API takes in the GSTIN of the Requester(Taxpayer or Transporter) and E-Way bill number to give the details of the E-Way bill.

Overview

This API takes in the gstin of the Requester(Taxpayer or Transporter) and E-Way bill number to give the details of the E-Way bill.

Endpoint

HTTP MethodResource
Get/ewb/tax-payer/seller/bills/{ewb_no}

API Endpoint Contact Us  Free Trial

Request

Follow the below guidelines to pass the below parameters to call the API.

Headers

ParamTypeDescriptionExample
x-api-keystringAn API key is a public key to identify users when calling any Sandbox API.key_live_ZUQT5UEf4......
AuthorizationstringJWT Authorization token which is generated using E-Way Bill Authentication API.eyJhsebihGyUf......

Path Parameters

ParamTypeDescriptionExample
ewb_nostringE-way bill number131001298692

Once the values are added, Your curl will look something like this

curl --request GET \
     --url https://api.sandbox.co.in/ewb/tax-payer/seller/bills/131001298692 \
     --header 'Authorization: xxxxxxxxxx' \
     --header 'accept: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0'

Response

ParamTypeDescriptionExamples
ewbNonumE-way bill Generated131000026768
ewayBillDatestringE-Way bill date26/09/2018 02:40:00 PM
genModestringMode of generation of E-Way Bill
Possible Value -
API : Application Programming InterfaceExc: Bulk Upload
SMS: SMS Facility
APP: Mobile APP
WEB: Web-based system
API
userGstinstringGSTIN of the user
supplyTypestringSupply whether it is outward/inward.
Possible value -
I : Inward
O : Outward
O
subSupplyTypestringSub types of Supply
Possible value -
1 : Supply
2 : Import
3 : Export
4 : Job Work
5 : For own use
6 : Job Work Returns
7 : Sales Return
8 : Others
9 : SKD/CKD/Lots
10 : Line Sales
11 : Recipient not known
12 : Exhibition or Fairs
Import
docTypestringDocument Type
Possible value -
INV : Tax Invoice
BIL : Bill of Supply
BOE : Bill of Entry
CHL : Delivery Challan
OTH : Others
Delivery Challan
docNostringDocument No12
docDatestringDocument Date12/09/2017
fromGstinstringGSTIN of the Consignor29AAAAA0300L1Z8
fromTrdNamestringLegalName of consignorABHYUDHYA CO OP BANK
fromAddr1stringAddress of consignor - Line 1Shambhai Fortune
fromAddr2stringAddress of consignor - Line 2Behind KSRTC Bus Stop
fromPlacestringPlace of consignorBengaluru
fromPincodenumPin code of consignor576101
fromStateCodenumState of consignor
Possible value -
1 : JAMMU AND KASHMIR
2 : HIMACHAL PRADESH
3 : PUNJAB
4 : CHANDIGARH
5 : UTTARAKHAND
6 : HARYANA
7 : DELHI
8 : RAJASTHAN
9 : UTTAR PRADESH
10 : BIHAR
11 : SIKKIM
12 : ARUNACHAL PRADESH
13 : NAGALAND
14 : MANIPUR
15 : MIZORAM
16 : TRIPURA
17 : MEGHALAYA
18 : ASSAM
19 : WEST BENGAL
20 : JHARKHAND
21 : ORRISA
22 : CHATTISGARH
23 : MADHYA PRADESH
24 : GUJARAT
26 : DADAR AND NAGAR HAVELI & DAMAN AND DIU
27 : MAHARASHTRA
29 : KARNATAKA
30 : GOA
31 : LAKSHADWEEP
32 : KERELA
33 : TAMIL NADU
34 : PUDUCHERRY
35 : ANDAMAN AND NICOBAR
36 : TELENGANA
37 : ANDHRA PRADESH
38 : LADAKH
97 : OTHER TERRITORY
99 : OTHER COUNTRY
KARNATAKA
actFromStateCodenumState of Supply
Possible value -
1 : JAMMU AND KASHMIR
2 : HIMACHAL PRADESH
3 : PUNJAB
4 : CHANDIGARH
5 : UTTARAKHAND
6 : HARYANA
7 : DELHI
8 : RAJASTHAN
9 : UTTAR PRADESH
10 : BIHAR
11 : SIKKIM
12 : ARUNACHAL PRADESH
13 : NAGALAND
14 : MANIPUR
15 : MIZORAM
16 : TRIPURA
17 : MEGHALAYA
18 : ASSAM
19 : WEST BENGAL
20 : JHARKHAND
21 : ORRISA
22 : CHATTISGARH
23 : MADHYA PRADESH
24 : GUJARAT
26 : DADAR AND NAGAR HAVELI & DAMAN AND DIU
27 : MAHARASHTRA
29 : KARNATAKA
30 : GOA
31 : LAKSHADWEEP
32 : KERELA
33 : TAMIL NADU
34 : PUDUCHERRY
35 : ANDAMAN AND NICOBAR
36 : TELENGANA
37 : ANDHRA PRADESH
38 : LADAKH
97 : OTHER TERRITORY
99 : OTHER COUNTRY
CHANDIGARH
toGstinstringGSTIN of consignee29ACGPI2251K1ZJ
toTrdnamestringLegal name of consigneeINDER CHHAJER
toAddr1stringAddress of consignee - Line 1PRIYADARSHANI LAYOUT
toAddr2stringAddress of consignee- Line 2MUDALAYAPALYA
toPlacestringPlace of consigneeBengaluru
toPincodenumPincode of the consignee560072
toStateCodenumState of Supply
Possible value -
1 : JAMMU AND KASHMIR
2 : HIMACHAL PRADESH
3 : PUNJAB
4 : CHANDIGARH
5 : UTTARAKHAND
6 : HARYANA
7 : DELHI
8 : RAJASTHAN
9 : UTTAR PRADESH
10 : BIHAR
11 : SIKKIM
12 : ARUNACHAL PRADESH
13 : NAGALAND
14 : MANIPUR
15 : MIZORAM
16 : TRIPURA
17 : MEGHALAYA
18 : ASSAM
19 : WEST BENGAL
20 : JHARKHAND
21 : ORRISA
22 : CHATTISGARH
23 : MADHYA PRADESH
24 : GUJARAT
26 : DADAR AND NAGAR HAVELI & DAMAN AND DIU
27 : MAHARASHTRA
29 : KARNATAKA
30 : GOA
31 : LAKSHADWEEP
32 : KERELA
33 : TAMIL NADU
34 : PUDUCHERRY
35 : ANDAMAN AND NICOBAR
36 : TELENGANA
37 : ANDHRA PRADESH
38 : LADAKH
97 : OTHER TERRITORY
99 : OTHER COUNTRY
totalValuenumSum of Taxable value2000
totInvValuenumTotal Invoice Value
cgstValuenumCGST Amount0
sgstValuenumSGST Amount0
igstValuenumIGST Amount240
cessValuenumCESS Amount20
cessNonAdvolValuenumCESS Non Advol Amount20
otherValuenumOther Charges if any0.01
actToStateCodenumState of Supply
Possible value -
1 : JAMMU AND KASHMIR
2 : HIMACHAL PRADESH
3 : PUNJAB
4 : CHANDIGARH
5 : UTTARAKHAND
6 : HARYANA
7 : DELHI
8 : RAJASTHAN
9 : UTTAR PRADESH
10 : BIHAR
11 : SIKKIM
12 : ARUNACHAL PRADESH
13 : NAGALAND
14 : MANIPUR
15 : MIZORAM
16 : TRIPURA
17 : MEGHALAYA
18 : ASSAM
19 : WEST BENGAL
20 : JHARKHAND
21 : ORRISA
22 : CHATTISGARH
23 : MADHYA PRADESH
24 : GUJARAT
26 : DADAR AND NAGAR HAVELI & DAMAN AND DIU
27 : MAHARASHTRA
29 : KARNATAKA
30 : GOA
31 : LAKSHADWEEP
32 : KERELA
33 : TAMIL NADU
34 : PUDUCHERRY
35 : ANDAMAN AND NICOBAR
36 : TELENGANA
37 : ANDHRA PRADESH
38 : LADAKH
97 : OTHER TERRITORY
99 : OTHER COUNTRY
fromPlacestringPlace of consignorBANGLORE SOUTH
fromStatenumState of Consignor
Possible value -
1 : JAMMU AND KASHMIR
2 : HIMACHAL PRADESH
3 : PUNJAB
4 : CHANDIGARH
5 : UTTARAKHAND
6 : HARYANA
7 : DELHI
8 : RAJASTHAN
9 : UTTAR PRADESH
10 : BIHAR
11 : SIKKIM
12 : ARUNACHAL PRADESH
13 : NAGALAND
14 : MANIPUR
15 : MIZORAM
16 : TRIPURA
17 : MEGHALAYA
18 : ASSAM
19 : WEST BENGAL
20 : JHARKHAND
21 : ORRISA
22 : CHATTISGARH
23 : MADHYA PRADESH
24 : GUJARAT
26 : DADAR AND NAGAR HAVELI & DAMAN AND DIU
27 : MAHARASHTRA
29 : KARNATAKA
30 : GOA
31 : LAKSHADWEEP
32 : KERELA
33 : TAMIL NADU
34 : PUDUCHERRY
35 : ANDAMAN AND NICOBAR
36 : TELENGANA
37 : ANDHRA PRADESH
38 : LADAKH
97 : OTHER TERRITORY
99 : OTHER COUNTRY
29
remainingDistancenumremainingDistance50
transDocNostringtransDocNoTrnDoc123
transDocDatestringTransporter Document Date12/09/2017
extnRemarksnumextnRemarks
Possible value -
1 : Natural Calamity
2 : Law and Order Situation
4 : Transshipment
5 : Accident
99 : Others
1
transModenumMode of Transport
Possible value -
1 : Road
2 : Rail
3 : Air
4 : Ship
5 : inTransit
1
extnRsnCodenumextnRsnCode1
fromPincodenumfromPincode560090
consignmentStatusstringconsignmentStatus
Possible value -
M : inMovement
T : inTransit
T
transitTypestringtransitTypeR
addressLine1stringaddressLine1Bengaluru
addressLine2stringaddressLine2Bengaluru
addressLine3stringaddressLine3Bengaluru
transporterNamestringName of the Transporter-
vehicleTypecharType of Vehicle
Possible value -
R : Regular
O : ODC(Over Dimensional Cargo)
R
validUptostringRefers to valid date of E-way Bill26/09/2018 12.00:00 PM
noValidDaysnumNumber of Valid Days1
rejectStatuscharStatus of Rejection of E-Way BillN
actualDistnumTotal distance between two transportation points100
transactionTypenumType of transaction
Possible value -
1 : Regular
2 : Bill To - Ship To
3 : Bill From - Dispatch From
4 : Combination of 2 and 3
1
transporterIdstringTransporter Id29BQSPA3829E1Z0
extendedTimesnumNumber of Times extended0
statusstringE-Way Bill Status
Possbile Values -
ACT: Active
CNL: Cancelled
DIS: Discarded
Active
itemListarrayArray of Objects containing Product DetailsLook below
vehicleListDetailsarrayArray of Objects containing Vehicle DetailsLook below

itemList

ParamTypeDescriptionExample
itemNonumIndex number of the item1
productNamestringName of the ProductSteel
productIdnumId of the Product0
productDescstringDescription of the Product5 mm Rod
hsnCodenumHSN Code of the Product10101
quantitynumQuantity of Product in Numbers200
qtyUnitstringUnit of the Product, like Liter,Kg etc
Possible value -
BAG : BAGS
BAL : BALE
BDL : BUNDLES
BKL : BUCKLES
BOU : BILLION OF UNITS
BOX : BOX
BTL : BOTTLES
BUN : BUNCHES
CAN : CANS
CBM : CUBIC METERS
CCM : CUBIC CENTIMETERS
CMS : CENTI METERS
CTN : CARTONS
DOZ : DOZENS
DRM : DRUMS
GGK : GREAT GROSS
GMS : GRAMMES
GRS : GROSS
GYD : GROSS YARDS
KGS : KILOGRAMS
KLR : KILOLITRE
KME : KILOMETRE
LTR : LITRES
MTR : METERS
MLT : MILILITRE
MTS : METRIC TON
NOS : NUMBERS
OTH : OTHERS
PAC : PACKS
PCS : PIECES
PRS : PAIRS
QTL : QUINTAL
ROL : ROLLS
SET : SETS
SQF : SQUARE FEET
SQM : SQUARE METERS
SQY : SQUARE YARDS
TBS : TABLETS
TGM : TEN GROSS
THD : THOUSANDS
TON : TONNES
TUB : TUBES
UGS : US GALLONS
UNT : UNITS
YDS : YARDS
QTS
taxableAmountnumTaxable Amount100000
cgstRatenumCGST Rate9
sgstRatenumSGST Rate9
igstRatenumIGST Rate18
cessRatenumCESS Rate0
cessNonadvolnumCess Non-Advolerum0

vehicleListDetails

ParamTypeDescriptionExample
updModenumMode of updation of E-Way Bill
Possible Value -
API : Application Programming Interface
Exc: Bulk Upload
SMS: SMS Facility
APP: Mobile APP
WEB: Web-based system
API
vehicleNostringNumber of the VehiclePQR1234
fromPlacestringPlace of ConsignorBengaluru
fromStatestringState of Consignor
Possible value -
1 : JAMMU AND KASHMIR
2 : HIMACHAL PRADESH
3 : PUNJAB
4 : CHANDIGARH
5 : UTTARAKHAND
6 : HARYANA
7 : DELHI
8 : RAJASTHAN
9 : UTTAR PRADESH
10 : BIHAR
11 : SIKKIM
12 : ARUNACHAL PRADESH
13 : NAGALAND
14 : MANIPUR
15 : MIZORAM
16 : TRIPURA
17 : MEGHALAYA
18 : ASSAM
19 : WEST BENGAL
20 : JHARKHAND
21 : ORRISA
22 : CHATTISGARH
23 : MADHYA PRADESH
24 : GUJARAT
26 : DADAR AND NAGAR HAVELI & DAMAN AND DIU
27 : MAHARASHTRA
29 : KARNATAKA
30 : GOA
31 : LAKSHADWEEP
32 : KERELA
33 : TAMIL NADU
34 : PUDUCHERRY
35 : ANDAMAN AND NICOBAR
36 : TELENGANA
37 : ANDHRA PRADESH
38 : LADAKH
97 : OTHER TERRITORY
99 : OTHER COUNTRY
29
tripshtNonumHSN Code of the Product10101
userGSTINTransinstringUser GSTIN29AAAAA0300L1Z8
enteredDatestringEntered Date of the Transporter26/09/2018 02:40:00 PM
transModenumMode of Transport
Possible value -
1 : Road
2 : Rail
3 : Air
4 : Ship
5 : inTransit
1
transDocNostringTransporter Document number12-86/3
transDocDatestringTransporter Document Date12/09/2017
groupNonumGroup Number1

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since Generate E-Way Bill is a Paid API, a wallet charge of INR 0.25 + GST will take place.

Versioning

This API is currently in major version 1.0. Refer to our versioning policies here