Skip to content

Auth Token#

Given a request-id and corresponding OTP, Saves the Auth Token received from GSTN.

Route

/basic/gstn/{flynn-version}/taxpayerapi/{gstn-api-version}/authenticate/AUTHTOKEN

  • active ‘flynn-version’: v1.0
  • method: POST

URL Parameters#

Name Description Type
flynn-version version of the API
for example, v1.0		 string
gstn-api-version GSTN API version
for example, v0.2		 string

Headers#

All headers are mentioned in common GSTN headers

Request#

Body consists of the following payload and has GSTIN and username of the authenticating user

Sample Request Body

{
  "otp-request-id": "c7d5da63-c532-43ff-9c32-e6e43dd58072",
  "otp": "123456"
}

Response#

200:#

Successful response will have the session ID for the authenticated Session with GSTN in “data” attribute as a String. This will be used in the subsequent GSTN API call.

Sample response body

{
  "data": {
    "gst-session-id": "5ec6bafa-6ad2-4641-82ec-80511b45e30b"
  }
}