GSTIN Verification — Basic Taxpayer Details
Verify any GSTIN and retrieve taxpayer name, registration date, status, and business type. Quick GST validation for onboarding workflows.
curl -X GET "https://production.deepvue.tech/v1/verification/gstinlite?gstin_number=example_string" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
-H "x-api-key: YOUR_API_KEY"
import requests
import json
url = "https://production.deepvue.tech/v1/verification/gstinlite?gstin_number=example_string"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://production.deepvue.tech/v1/verification/gstinlite?gstin_number=example_string", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://production.deepvue.tech/v1/verification/gstinlite?gstin_number=example_string", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN (JWT)")
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://production.deepvue.tech/v1/verification/gstinlite?gstin_number=example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN (JWT)'
request['x-api-key'] = 'YOUR_API_KEY'
response = http.request(request)
puts response.body
{
"code": 200,
"timestamp": 1738051954177,
"transaction_id": "09d1a4fd-be05-44f4-a4b6-6c14cf375d1f",
"data": {
"stjCd": "MHCG0660",
"lgnm": "BLUE DART EXPRESS LIMITED",
"stj": "MALAD_WEST_509",
"dty": "Regular",
"adadr": [
{
"addr": {
"bnm": "",
"loc": "ANDHERI-EAST",
"st": "SAHAR ROAD",
"bno": "BLUE DART CENTRE,",
"dst": "Mumbai",
"lt": "",
"locality": "",
"pncd": "400099",
"landMark": "",
"stcd": "Maharashtra",
"geocodelvl": "NA",
"flno": "",
"lg": ""
},
"ntr": "Input Service Distributor (ISD), Retail Business, Service Provision, Recipient of Goods or Services"
}
],
"tradeNam": "BLUE DART EXPRESS LIMITED",
"ctjCd": "VM0301",
"sts": "Active",
"ctj": "RANGE-I",
"einvoiceStatus": "Yes"
}
}
{
"code": 200,
"timestamp": 1738051954177,
"transaction_id": "09d1a4fd-be05-44f4-a4b6-6c14cf375d1f",
"data": {
"error_code": "NOGSTIN",
"message": "No records found"
}
}
{
"code": 200,
"timestamp": 1738051954177,
"transaction_id": "09d1a4fd-be05-44f4-a4b6-6c14cf375d1f",
"data": {
"error_code": "SWEB_9035",
"message": "Invalid GSTIN / UID"
}
}
{
"detail": "Inactive client_id"
}
{
"detail": "Not authenticated"
}
{
"detail": "Not a valid token"
}
{
"code": 422,
"timestamp": 1738052019250,
"transaction_id": "4bb474ac-863b-4884-8a7f-b481a087047a",
"message": "Invalid GSTIN pattern"
}
{
"detail": "Internal Server Error"
}
/v1/verification/gstinlite
ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Query Parameters
Responses
Overview
The GST Basic Verification API validates a GSTIN against the GST Portal and returns core registration details. It is designed for fast, lightweight checks during onboarding — confirm that a business is GST-registered, cross-check the trade name, and verify its active status in a single call.
The API accepts a single required parameter: a 15-character alphanumeric GSTIN (Goods and Services Tax Identification Number).
When to use GST Basic
Use GST Basic when you need a quick validation and don't require filing history or detailed compliance data. Common scenarios include:
- Merchant or vendor onboarding — confirm GST registration before creating a business profile
- Invoice validation — verify the GSTIN printed on an invoice is real and active
- Form pre-fill — auto-populate trade name and business type from a GSTIN during sign-up
If you need filing history, HSN codes, promoter details, or turnover data, use GST Advanced Verification instead.
Fields returned
| Field | Included | Description |
|---|---|---|
| Legal name | Yes | Registered legal name of the business |
| Trade name | Yes | Trading name / brand name |
| Registration date | Yes | Date the GSTIN was registered |
| Status | Yes | Active, cancelled, or suspended |
| Business type | Yes | Constitution of business (e.g., Proprietorship, LLP) |
| Taxpayer type | Yes | Regular, Composition, or Input Service Distributor |
| State jurisdiction | Yes | State and center jurisdiction codes |
| Principal address | No | Use GST Advanced |
| Filing history | No | Use GST Advanced |
| HSN codes | No | Use GST Advanced |
| Promoter details | No | Use GST Advanced |
| Annual turnover | No | Use GST Advanced |
GST Basic vs GST Advanced
GST Basic
Fast validation — trade name, status, business type. Best for onboarding and invoice checks where speed matters.
GST Advanced
Deep due diligence — filing history, HSN codes, promoters, turnover, addresses. Best for vendor risk assessment and compliance audits.
One Access Token is valid for 24 hours. After expiry, renew it using the Authorization endpoint.
Last updated 4 weeks ago
Built with Documentation.AI