Skip to main content
POST
/
gst
/
compliance
/
tax-payer
/
otp
/
verify
Verify OTP
curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/tax-payer/otp/verify \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "username": "acme.com",
  "gstin": "29AAACQ3770E000"
}
'
{
  "code": 200,
  "data": {
    "access_token": "{{$headers 'authorization'}}",
    "session_expiry": 1712947711000,
    "status_cd": "1",
    "token_expiry": 1712947711000
  },
  "timestamp": 1712926110000,
  "transaction_id": "f6a85bd7-6d53-4e60-b4a7-480d3738ff0c"
}
Prerequisites: You must enable API access to get access to GST APIs. If not done already, enable API access.

Headers

ā€‹
Authorization
string
required

JWT access token

ā€‹
x-source
string
default:primary

Source. Possible Values: primary (default) or secondary

Example:

"primary"

ā€‹
x-api-key
string
required

API key for identification

ā€‹
x-api-version
string
default:1.0.0

API version

Query Parameters

ā€‹
otp
integer<int32>
required

One time password

Example:

"575757"

Body

application/json
ā€‹
username
string
required

Username as per GST portal

ā€‹
gstin
string
required

GSTIN of the taxpayer

Response

AUTH4033 Invalid session / 200 Success

ā€‹
code
number
Example:

200

ā€‹
data
object
ā€‹
timestamp
number
Example:

1763446641000

ā€‹
transaction_id
string
Example:

"1ad1d698-499e-4b10-a44a-fecba43babbb"