If you have an active e-Invoice session, use its access token instead of authenticating again.
Prerequisites: If you haven’t created API credentials on the E-Way Bill portal yet, follow the steps in the Create API Credentials guide first, then return to this recipe.
Authenticate
To begin the GST E-Way Bill workflow, your application must first authenticate using the Authenticate endpoint to obtain the Sandbox JWT access token.This endpoint requires your API Key and API Secret, and returns a JWT access token that’s valid for 24 hours. This token is required for all subsequent API calls.
When authentication is successful, you’ll receive the Sandbox JWT access token in the response. This token must be used in the
cURL Request
cURL Request
authorization header (without the Bearer prefix) for all subsequent API calls.Authenticate with E-Way Bill API
Once you have the Sandbox JWT access token, authenticate with the E-Way Bill portal using the E-Way Bill Authentication endpoint.You need to provide the username and password that were created on the E-Way Bill portal, along with the taxpayer’s GSTIN (15-character GST Identification Number).
Authentication returns an access token and an expiry timestamp. This example uses
cURL Request
cURL Request
x-source: primary for NIC1. See NIC1 and NIC2 routing for session and destination selection.