Overview

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

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

URL

<URL>/ewayapi/GetEwayBillsForTransporterByState

Content-Type

application/json

Method

GET

URL Parameters

date (DD/MM/YYYY), stateCode

URL Parameter Description

date – E-way bill generated Date , stateCode – state code of the generator of the E-waybill - 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.