If you have an active E-Way Bill session, use its access token instead of authenticating again.
Prerequisites: If you haven’t created API credentials on the E-Invoice portal (NIC) yet, follow the steps in the Create API Credentials guide first, then return to this recipe.
Authenticate
To begin the GST E-Invoice 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-Invoice API
Once you have the Sandbox JWT access token, authenticate with the E-Invoice portal using the E-Invoice Authentication endpoint.You need to provide the username and password that were created on the E-Invoice portal (NIC), along with the taxpayer’s GSTIN (15-character GST Identification Number). The
Authentication returns an access token and an expiry timestamp. This example uses
force query parameter should be set to true if you need to refresh the token 10 minutes before expiry.cURL Request
cURL Request
x-source: primary for NIC1. See NIC1 and NIC2 routing for session and destination selection.