Skip to main content
POST

NIC validations

  1. An attribute “status” has been Added(‘ACT’ or ‘CNL’ or ‘INA’ or ‘PRO’)
  2. An attribute “blkStatus” has been Added
    i) ‘U’ or ’ ’ for Unblocked
    ii) ‘B’ for blocked

Request body schema

View request body schema

Response schema

For successful responses, this reference describes the NIC E-Way Bill payload at data.data.

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

Body

application/json

E-Way Bill schema.

gstin
string
required

GSTIN of the taxpayer

Response

200 - application/json

200 GSTIN details fetched / 325 Could not retrieve data

An E-Way Bill success or NIC business-failure response. Both variants use HTTP 200.

code
enum<integer>
required

NIC response code.

Available options:
200
timestamp
integer<int64>
required

Unix timestamp.

transaction_id
string
required

Request transaction identifier.

data
object
required