GST Verification

This API lets you verify GSTIN via an OTP-based mechanism.

  1. First, an OTP is generated and sent to the registered phone number and email address of the principal contact of that GST business.
  2. Then, on successfully verifying the OTP, the associated owner of the GSTIN is verified.

📘

OTPs will be sent to the primary contact for the business.


Usecase

GSTIN is publicly available information. Therefore, individuals can wrongly claim ownership of GSTIN when trying to do business with others. Hence, one way to verify the ownership of the GSTIN is to check if the person indeed has access to the phone number and the e-mail id associated with the GSTIN (as per GST Portal).


Sample OTP

Email

  • Dear taxpayer,
    {{OTP}} is the OTP to verify your GST registration {{GSTIN}}. OTP is valid till {{hh:mm:ss IST}}. Do not share OTP with anyone.

Mobile

  • {{OTP}} is the OTP to verify your GST registration {{GSTIN}}. OTP is valid till {{hh:mm:ss IST}}. Do not share OTP with anyone.

Generate OTP

Endpoint

HTTP METHOD

Resource

Description

POST

/gst-portal/tax-payers/:gstin/otp

Generates OTP to the primary contact of the GSTIN

API EndpointAPI Endpoint

❗️

OTPs will be valid for 10 minutes.


Verify OTP

Endpoint

HTTP METHOD

Resource

Description

POST

/gst-portal/tax-payers/:gstin/otp/verify?otp={{otp}}

Verifies OTP generated for GSTIN

API EndpointAPI Endpoint


Did this page help you?