Skip to main content
GET

​
NIC validations

  1. The assignment date must be valid.
  2. Only active e-way bills are returned.
  3. Generator state codes must be valid.
  4. The NIC list API allows 50 requests per 15-minute window, starting with the first request. Further requests return error 658 until the window ends.
Vehicle-history lookups also follow the Get E-Way Bill validations.

​
Response schema

Schema of the JSON file at data.json_url, including vehicle history and lookup errors.

View JSON schema

Authorizations

​
authorization
string
header
required

E-Way Bill taxpayer access token returned by Authenticate.

​
x-api-key
string
header
required

Sandbox API key from your Sandbox account.

Headers

​
x-api-version
string
default:1.0.0

API version

​
x-source
string

IRP source used for the request.

Query Parameters

​
date
string
required

Assignment date in DD/MM/YYYY format. Pass one valid calendar date.

Required string length: 10
Pattern: ^(0[1-9]|[12][0-9]|3[01])/(0[1-9]|1[0-2])/[0-9]{4}$
​
state_codes
string[]

Generator state codes, comma-separated. Omit to fetch all supported states.

Minimum array length: 1
Pattern: ^\s*[0-9]{1,2}\s*$

Response

Returns a signed URL for the enriched JSON file. The file can contain state-level errors or bill-level vehicle detail errors.

​
data
object
required
​
code
enum<integer>
required
Available options:
200
​
timestamp
integer
required

Response timestamp in Unix milliseconds.

​
transaction_id
string
required