Skip to main content
POST
/
gst
/
compliance
/
e-way-bill
/
tax-payer
/
authenticate
E-Way Bill Authentication
curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/e-way-bill/tax-payer/authenticate \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "username": "ACME_IND_API_QCK",
  "password": "QnVzaW5lc3NfQVBJX1FDSw",
  "gstin": "29AAACQ3770E000"
}
'
{
  "code": 200,
  "data": {
    "error": {
      "errorCodes": "108"
    },
    "info": "",
    "status": "0"
  },
  "timestamp": 1763446641000,
  "transaction_id": "ca515f62-749d-4037-b4cc-adca5db77cd7"
}

ā€‹
Request body schema

View request body schema

Prerequisites: You must have API credentials to hit E-Way Bill APIs. If not, create API credentials.

Headers

ā€‹
Authorization
string
required

JWT access token

ā€‹
x-source
string
default:primary

Source. Possible Values: primary, secondary or tertiary

Example:

"primary"

ā€‹
x-api-key
string
required

API key for identification

ā€‹
x-api-version
string
default:1.0.0

API version

Body

application/json
ā€‹
username
string
required

API username of taxpayer as set on E-Way Bill portal

ā€‹
password
string
required

API password of taxpayer as set on E-Way Bill portal

ā€‹
gstin
string
required

GSTIN of the taxpayer

Response

200 - application/json

200 Authenticated / 108 Invalid login credentials

ā€‹
code
number
Example:

200

ā€‹
data
object
ā€‹
timestamp
number
Example:

1763446641000

ā€‹
transaction_id
string
Example:

"2ab9923e-f844-4b6c-8fc7-0bcc767bafc7"