E-way bill and e-invoice API credentials: setup guide

A one-time step per GSTIN on the government portals, before e-way bills and e-invoices can go through gstinapi.in. About five minutes, with an OTP on your registered mobile.

Short answer

On each portal, create an API user for the GSP Chartered Information Systems Private Limited, with a password of letters and digits only. Send that username and password with your API calls, never your normal portal login. Test them free before your first document: most "Invalid login credentials" (error 108) failures are an API user made for a different GSP.

E-way bill portal (ewaybillgst.gov.in)

  1. 1Log in at ewaybillgst.gov.in with your usual e-way bill username and password.
  2. 2In the left menu, open Registration and then For GSP.
  3. 3Click Send OTP, enter the code sent to your registered mobile or email, then Verify OTP.
  4. 4Click Add / New.
  5. 5Under GSP Name, pick Chartered Information Systems Private Limited from the dropdown.
  6. 6Part of the username is filled in for you: add a short suffix of your own and confirm it in the re-enter field. This is your e-way bill API username.
  7. 7Set a password and re-enter it. Use letters and digits only: special characters are a common cause of error 108.
  8. 8Click Add. The new API username appears in the GSP list on that page, which means it is live.

E-invoice portal (einvoice1.gst.gov.in)

Only if you generate e-invoices. This is a separate API user from the e-way bill one, even for the same GSTIN.

  1. 1Log in at einvoice1.gst.gov.in with your usual e-invoice username and password.
  2. 2In the left menu, open API Registration, then User Credentials, then Create API User.
  3. 3Enter the OTP sent to your registered mobile number and click Verify OTP.
  4. 4Choose Through GSP, not Directly.
  5. 5Under Select your GSP, pick Chartered Information Systems Private Limited.
  6. 6Type a username and a password (letters and digits only), re-enter the password and click Submit. This is your e-invoice API username.
  7. 7The message "Account created successfully" means it is ready.

Test the credentials before your first document

The credentials test logs in with your API user and does nothing else. No document is created, nothing is charged and the password is not stored. If the login is refused, it tells you the likely cause.

Or from code, with your API key:

curl -X POST "https://gstinapi.in/v1/ewaybill/credentials/test" \
  -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"gstin":"24AAAAA0000A1Z5","gstin_username":"YOUR_EWB_API_USER","password":"YOUR_EWB_API_PASSWORD"}'

Up to 3 tests per GSTIN every 15 minutes, because the government login service only allows a few attempts.

What to send with each call

CallFields
POST /v1/ewaybill (and other e-way bill calls)gstin, gstin_username, password
POST /v1/einvoicegstin, einv_username, password
POST /v1/einvoice/cancelgstin, einv_username, password, irn (gstin_username still accepted)

Build the integration first without any of this: every e-way bill and e-invoice call accepts "test_mode": true and returns a sample in the live shape, free. See the API reference.

Questions

What does e-way bill error 108 "Invalid login credentials" mean?
The portal refused the API username or password. The usual causes are an API user created for a different GSP (for example inside your accounting software), a typo, or special characters in the password. Create a new API user for Chartered Information Systems Private Limited with a letters-and-digits password, then test it free before generating a document.
Which GSP should I choose for gstinapi.in?
Chartered Information Systems Private Limited. An API user only works with the GSP it was created for, so credentials made for another GSP are refused.
Is the API password my GST portal password?
No. It is a new username and password you create for API access. Never send your normal GST portal or e-way bill portal login to any API provider.
Do I need separate credentials for e-way bill and e-invoice?
Yes. The e-way bill portal and the e-invoice portal each have their own API user, even for the same GSTIN.
Can I check the credentials without generating a document?
Yes. The credentials test logs in and does nothing else: no document is created and nothing is charged. Use it from the dashboard, or call POST /v1/ewaybill/credentials/test or /v1/einvoice/credentials/test with your API key.

Chartered Information Systems Private Limited is the GST Suvidha Provider gstinapi.in's e-way bill and e-invoice integration runs on. Portal steps can change; if a screen looks different, tell us. Not affiliated with the Government of India.