---
title: "Verify Otp"
method: POST
path: "/v1/gst/tax-payer/verify-otp"
tags: ["GST Taxpayer APIs"]
---

# Verify Otp

`POST /v1/gst/tax-payer/verify-otp`

## Request

- Base URL: `https://api.deepvue.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.deepvue.ai/v1/gst/tax-payer/verify-otp`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `authorize`
- TypeScript: <https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide/docs/v1/gst/tax-payer/verify-otp/post.ts> (a function with typed inputs; its response is checked against the schema)

- Once the last two steps are successfully completed. That is - the user has enabled API access on his GST Portal and GenerateOtp API an OTP has been sent. Then, this API is used to verify the OTP and enable access to GST Portal.
- This API will start a session and provide access valid for 6 hrs. Returns date timestamp of the expiry of the session.
- The end result of Tax Payer authentication process is to establish an authorization token for the session which needs to be included in the header for all subsequent API calls.

## Query parameters

- `gstin_number` string, required
- `user_name` string, required
- `otp` string, required

## Response `200`

Successful Response

- RESPONSEGSTINVERIFYOTPSUCCESSFUL
  - `code` integer
  - `timestamp` integer, required
  - `transaction_id` string, required
  - `data` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide.md) - [All operations](https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide/llms.txt) - [OpenAPI document](https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide/revisions/c1b0558e7d77?raw)