Overview

This method provides the list of E-way bills assigned to GSTIN/TRANSIN for transportation based on date of assignment of the E-waybill and state code

The format and details of GetEwayBillsForTransporter API request is depicted in following table.

URL

<URL>/ewayapi/GetEwayBillReportByTransporterassignedDate

Content-Type

application/json

Method

GET

URL Parameters

stateCode, date (DD/MM/YYYY)

URL Parameter Description

date – , stateCode – state code of the generator of the E-waybill and E-way bill assigned Date- Parameters needs to be passed in the order in which it is listed

Request Payload

Request Header

Attributes Description

client-id

clientid to be provided by E-WAY BILL SYSTEM

client-secret

Secret to be provided by E-WAY BILL SYSTEM

Gstin

GSTIN of Requester(Transporter)

authtoken

Authentication token returned by the E-way bill system

Response Payload

Attributes Description Value
Status Status of request 1 – Success ; 0 - Error

Encrypt(Base64(Response JSON),rek)

Response of E-way bill assigned to a Transporter for a specific GSTIN Json string.

Encrypt(rek,sek)

Random encryption key which is encrypted using sek

Hmac ( Base64(JSON data ))

HMAC-SHA256 of Base64 data using AES key (rek) as HMAC Key

Sample Json for Get Eway Bills for Transporter By State

[
{
     "ewbNo": 731060739219,
     "ewbDate": "13/03/2019 11:01:00 AM ",
     "status": "ACT",
     "genGstin": "08AAAAD1307N1ZW",
     "docNo": "nictest",
     "docDate": "15/01/2019",
     "delPinCode": 560090,
     "delStateCode": 27,
     "delPlace":"Bangalore",
     "validUpto":"14/03/2019 11:59:00 PM",
     "extendedTimes":0,
     "rejectStatus":"N"
   }
  ]

Validations

  1. Valid EWB generated date has to be passed.
  2. Only active E-waybill will be considered in this API.
  3. Valid state code of the EWB generator has to be passed.
  4. Rate control limit has been set for accessing this API. This API can be accessed 50 times with in a span of 15 min. This 15 min window starts from the time of first access of this API, if API is accessed 50 times within this period, API will be blocked for the remaining duration of time period.
    For example: If you have accessed this API at 2:00 PM and tried 50 access till 2:05 PM then, you will be blocked till 2:15 PM for accessing this API as the allowed number of requests has been exceeded, you will get an error code 658. Again you are allowed to access this API only after 2.15 PM and the same above process will continue there after.