E-way bill and e-invoice API for India

Put vehicle details (EwbDtls) in the e-invoice payload and one call generates both the IRN and the e-way bill. It is billed once, not twice. The e-invoice response also carries the signed QR code and the signed invoice record, passed through as the filing system returns them.

The filing happens on the government network, so the GSTIN you file for must already have e-way bill API access set up. That is a one-time step on the e-way bill portal, separate from your gstinapi.in API key. To set it up:

1. Log in to the e-way bill portal (ewaybillgst.gov.in) as the taxpayer or transporter for that GSTIN.
2. Open the Registration menu and choose “For GSP”.
3. Select the GSP from the dropdown. Contact us and we will confirm the exact entry to pick.
4. Create the API username and password there. They are separate from your normal portal login.
5. Send us the GSTIN through the contact page so we can enable it on our side. Until then you can build and test with test_mode.

Each GSTIN, meaning each place of business, needs its own API username and password. Transporters follow the same steps. E-invoice needs its own separate API registration on the e-invoice portal, so contact us for that one.

You send the GSTIN’s own API username and password with each request. They are forwarded for that call and never stored.

The payload is one e-way bill JSON payload in the government’s format (supplyType, docType, docNo, fromGstin, toGstin, itemList and the rest). Add "test_mode": true to build against the sandbox.

curl -X POST https://www.gstinapi.in/v1/ewaybill \
  -H "x-api-key: gak_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "gstin": "YOUR_GSTIN",
    "gstin_username": "YOUR_EWAYBILL_API_USERNAME",
    "password": "YOUR_EWAYBILL_API_PASSWORD",
    "test_mode": true,
    "payload": { "docType": "INV", "docNo": "INV-001", "...": "the rest of the e-way bill payload" }
  }'

• 3 credits per successful document: generate, cancel and close each cost the same.
• A rejection, or a failure upstream, is never charged.
• The lookup endpoint costs 1 credit, because it is a real call to the filing system. A clean "no record found" answer is still charged for that reason.
• Sandbox calls (test_mode) are free: required fields are still validated, but the government network is never called, and every reference number is prefixed TEST- so it cannot be mistaken for a real one.
• On the 6,250-credit pack a credit is ₹0.40, so a document is about ₹1.20 before 18% GST.

If a call times out before a response comes back, retry with the same document number, never a new one. /v1/ewaybill then returns the already-generated e-way bill as a normal success, and /v1/einvoice returns the already-generated invoice’s real IRN with already_existed set to true. It is billed the same as a fresh success, and there is never a duplicate filing. A different document number is what risks a duplicate.