Skip to main content
GET

Validations

  1. date must be a valid calendar date in DD/MM/YYYY format.
  2. date_type must be assigned_at or generated_at.
  3. Only active e-way bills are returned.
  4. state_codes, when provided, must contain valid generator state codes separated by commas. Omission selects all supported states.
  5. List lookups allow 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.

JSON schema

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
enum<string>
default:primary

NIC server for the session used by this request. primary selects NIC1. secondary selects NIC2. Defaults to primary. See NIC1 and NIC2 routing.

Available options:
primary,
secondary
x-proxy
enum<string>

NIC server that receives the request. If omitted, the request goes to the server selected by x-source. When specified, selects the other server. See NIC1 and NIC2 routing.

Available options:
primary,
secondary

Query Parameters

date
string
required

A real calendar date in strict DD/MM/YYYY format. Each request covers one day.

Required string length: 10
Pattern: ^(0[1-9]|[12][0-9]|3[01])/(0[1-9]|1[0-2])/[0-9]{4}$
date_type
enum<string>
required

Use assigned_at for assignment date or generated_at for generation date.

Available options:
assigned_at,
generated_at
state_codes
string[]

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

Minimum array length: 1

Response

Returns a signed URL for the enriched JSON file and the usage units consumed by the request. 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