GSTIN Advanced Verification — Filing History
Get comprehensive GSTIN details — taxpayer name, address, filing history, HSN codes, and return filing status. Ideal for vendor due diligence.
curl -X GET "https://production.deepvue.tech/v1/verification/gstin-advanced?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/gstin-advanced?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/gstin-advanced?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/gstin-advanced?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/gstin-advanced?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": 1737862347191,
"transaction_id": "9f808ad40a1b49b6bb1839921248c37a",
"sub_code": "SUCCESS",
"message": "GSTIN Verified Successfully.",
"data": {
"contact_details": {
"principal": {
"address": "Belur Industrial Area, Works Office, Mummigatti Post, Pune Bangalore Road, Dharwad, Dharwad, Karnataka, 580011",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Factory / Manufacturing, Office / Sale Office, Recipient of Goods or Services, Service Provision, Wholesale Business, Retail Business"
},
"additional": [
{
"address": "BELUR INDUSTRIAL AREA, TMML, GARAG ROAD, MUMMIGATTI POSTT DHARWAD, Dharwad, Karnataka, 580011",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Others"
},
{
"address": "Kailash Vahan Udyog Limited Factory 21, Balagaranahalli Hosur main road, Attibele, Bengaluru Rural, Karnataka, 562107",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Others"
},
{
"address": "Warehouse, Survey No 331 and A/332, Marsur Village, Kasab Hobli, Anekal Taluk, Bengaluru Urban, Karnataka, 560081",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Others"
},
{
"address": "Plot No 317-P, 318-P, 319-P, Jigani-Bommasandra link Road, Jigani, Anekal Taluk, Bengaluru Urban, Karnataka, 562106",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Others"
},
{
"address": "Vehicle Maintenance Department, VRL Complex, 16KM Bangalore Road, NH4, Hubballi, Warur, Dharwad, Karnataka, 581207",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Warehouse / Depot"
},
{
"address": "Krishnapuram Jigani, Plot No 314 and 319, Tata Motors Ltd SPD CV, Anekal Taluk Jigani, Jigani-Bommasandra link Road, Sidlaghatta, Chikkaballapur, Karnataka, 562105",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Export, Recipient of Goods or Services, Warehouse / Depot, Office / Sale Office"
},
{
"address": "Mummigatti Post, Regional Sales Office, NH 4, Tata Motors Manufacturing Plant Dharwad, Belur Industrial Area, Belur Industrial Area, Dharwad, Karnataka, 580011",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Bonded Warehouse, Recipient of Goods or Services, Warehouse / Depot, Office / Sale Office, Export"
},
{
"address": "No 129/1B, IMAC India Coach Builders Pvt Ltd, Mysore Road, Kengeri, Bengaluru, Bengaluru Urban, Karnataka, 560060",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Others, Supplier of Services, Recipient of Goods or Services, Office / Sale Office"
},
{
"address": "2 and 3 Floor, # 648, Regional Area Office, 1st Main Road. Sector 6 HSR Layout, Bengaluru, Bengaluru Urban, Karnataka, 560102",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Office / Sale Office, Supplier of Services, Recipient of Goods or Services"
},
{
"address": "127, Tata Motors Limited -SATRAC ENGINEERING, SOMPURA INDUSTRIAL AREA, Nidavanda Village, Dobaspet Industrial Area, Bengaluru Rural, Karnataka, 562132",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Office / Sale Office, Others, Recipient of Goods or Services, Supplier of Services, Warehouse / Depot"
},
{
"address": "1A, 1st Floor, Roopena Agrahara., Fortune Summit,Sector 6 , under BBMP Ward No.174., 290/281/276/243/244, Hosur Road, Bommanahalli, Bengaluru, Bengaluru Urban, Karnataka, 560068",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Bonded Warehouse, Retail Business, Supplier of Services, Recipient of Goods or Services, Warehouse / Depot, Office / Sale Office"
},
{
"address": "Plot No. 176 C, SY No. 233 and 241, Anchemco India Pvt Ltd, Belur village, Dharwad Taluk, Garag Hobli, Belur Industrial Area, Dharwad, Dharwad, Karnataka, 580001",
"email": "gst.south@tatamotors.com",
"mobile": "9130094259",
"nature_of_business": "Bonded Warehouse, Warehouse / Depot, Office / Sale Office, Others, Export, Supplier of Services, Recipient of Goods or Services"
}
]
},
"promoters": [
"Girish Arun Wagh ",
"Om Prakash Bhatt "
],
"annual_turnover": "Slab: Rs. 500 Cr. and above",
"annual_turnover_fy": "2023-2024",
"percentage_in_cash_fy": "2023-2024",
"percentage_in_cash": "Slab: 2 to 5%",
"aadhaar_validation": "Yes",
"aadhaar_validation_date": "2024-12-06",
"address_details": {},
"gstin": "29AAACT2727Q1ZS",
"pan_number": "AAACT2727Q",
"business_name": "TATA MOTORS LTD",
"legal_name": "TATA MOTORS LIMITED",
"center_jurisdiction": "State - CBIC,Zone - BENGALURU,Commissionerate - BELAGAVI,Division - DHARWAR DIVISION,Range - DHARWAD-B RANGE (Jurisdictional Office)",
"state_jurisdiction": "State - Karnataka,Division - DGSTO Dharwad, LOCAL GST Office - LGSTO 310 - Dharwad",
"date_of_registration": "2017-07-01",
"constitution_of_business": "Public Limited Company",
"taxpayer_type": "Regular",
"gstin_status": "Active",
"date_of_cancellation": "1800-01-01",
"field_visit_conducted": "No",
"nature_bus_activities": [
"Factory / Manufacturing",
"Office / Sale Office",
"Recipient of Goods or Services",
"Service Provision",
"Wholesale Business",
"Retail Business",
"Others",
"Warehouse / Depot",
"Export",
"Bonded Warehouse",
"Supplier of Services"
],
"nature_of_core_business_activity_code": "MFT",
"nature_of_core_business_activity_description": "Manufacturer",
"filing_status": [
[
{
"return_type": "GSTR1",
"financial_year": "2024-2025",
"tax_period": "December",
"date_of_filing": "2025-01-11",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR1",
"financial_year": "2024-2025",
"tax_period": "November",
"date_of_filing": "2024-12-10",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR1",
"financial_year": "2024-2025",
"tax_period": "October",
"date_of_filing": "2024-11-11",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR1",
"financial_year": "2024-2025",
"tax_period": "September",
"date_of_filing": "2024-10-11",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR1",
"financial_year": "2024-2025",
"tax_period": "August",
"date_of_filing": "2024-09-11",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR1",
"financial_year": "2024-2025",
"tax_period": "July",
"date_of_filing": "2024-08-09",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR1",
"financial_year": "2024-2025",
"tax_period": "June",
"date_of_filing": "2024-07-10",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR1",
"financial_year": "2024-2025",
"tax_period": "May",
"date_of_filing": "2024-06-10",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR1",
"financial_year": "2024-2025",
"tax_period": "April",
"date_of_filing": "2024-05-10",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR1",
"financial_year": "2023-2024",
"tax_period": "March",
"date_of_filing": "2024-04-11",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR3B",
"financial_year": "2024-2025",
"tax_period": "December",
"date_of_filing": "2025-01-22",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR3B",
"financial_year": "2024-2025",
"tax_period": "November",
"date_of_filing": "2024-12-20",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR3B",
"financial_year": "2024-2025",
"tax_period": "October",
"date_of_filing": "2024-11-20",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR3B",
"financial_year": "2024-2025",
"tax_period": "September",
"date_of_filing": "2024-10-19",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR3B",
"financial_year": "2024-2025",
"tax_period": "August",
"date_of_filing": "2024-09-20",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR3B",
"financial_year": "2024-2025",
"tax_period": "July",
"date_of_filing": "2024-08-20",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR3B",
"financial_year": "2024-2025",
"tax_period": "June",
"date_of_filing": "2024-07-20",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR3B",
"financial_year": "2024-2025",
"tax_period": "May",
"date_of_filing": "2024-06-20",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR3B",
"financial_year": "2024-2025",
"tax_period": "April",
"date_of_filing": "2024-05-20",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR3B",
"financial_year": "2023-2024",
"tax_period": "March",
"date_of_filing": "2024-04-20",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9",
"financial_year": "2023-2024",
"tax_period": "Annual",
"date_of_filing": "2024-12-26",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9",
"financial_year": "2022-2023",
"tax_period": "Annual",
"date_of_filing": "2023-12-22",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9",
"financial_year": "2021-2022",
"tax_period": "Annual",
"date_of_filing": "2022-12-19",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9",
"financial_year": "2020-2021",
"tax_period": "Annual",
"date_of_filing": "2021-11-11",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9",
"financial_year": "2019-2020",
"tax_period": "Annual",
"date_of_filing": "2021-02-24",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9",
"financial_year": "2018-2019",
"tax_period": "Annual",
"date_of_filing": "2020-09-21",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9",
"financial_year": "2017-2018",
"tax_period": "Annual",
"date_of_filing": "2019-09-26",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9C",
"financial_year": "2023-2024",
"tax_period": "Annual",
"date_of_filing": "2024-12-26",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9C",
"financial_year": "2022-2023",
"tax_period": "Annual",
"date_of_filing": "2023-12-23",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9C",
"financial_year": "2021-2022",
"tax_period": "Annual",
"date_of_filing": "2022-12-21",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9C",
"financial_year": "2020-2021",
"tax_period": "Annual",
"date_of_filing": "2021-11-11",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9C",
"financial_year": "2019-2020",
"tax_period": "Annual",
"date_of_filing": "2021-02-25",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9C",
"financial_year": "2018-2019",
"tax_period": "Annual",
"date_of_filing": "2020-09-24",
"status": "Filed",
"mode_of_filing": "ONLINE"
},
{
"return_type": "GSTR9C",
"financial_year": "2017-2018",
"tax_period": "Annual",
"date_of_filing": "2019-10-22",
"status": "Filed",
"mode_of_filing": "ONLINE"
}
]
],
"address": null,
"hsn_info": {},
"filing_frequency": []
}
}
{
"detail": "Inactive client_id"
}
{
"detail": "Bad Request"
}
{
"detail": "Not authenticated"
}
{
"detail": "Invalid client_id"
}
{
"detail": "Could not validate credentials"
}
{
"detail": "Authorization failure"
}
{
"detail": "Not a valid token"
}
{
"detail": "Access forbidden"
}
{
"code": 422,
"timestamp": 1738052019250,
"transaction_id": "4bb474ac-863b-4884-8a7f-b481a087047a",
"message": "Invalid GSTIN pattern"
}
{
"detail": "Internal Server Error"
}
GET
/v1/verification/gstin-advanced
GET
Bearer Token (JWT)
Bearer Tokenstring
RequiredACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key (header: x-api-key)
x-api-keystring
RequiredThe CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
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
header
Authorizationstring
RequiredBearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
header
x-api-keystring
RequiredAPI Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Query Parameters
Responses
codeinteger
timestampinteger
transaction_idstring
sub_codestring
messagestring
dataobject
contact_detailsobject
principalobject
addressstring
emailstring
mobilestring
nature_of_businessstring
additionalarray
addressstring
emailstring
mobilestring
nature_of_businessstring
promotersstring[]
annual_turnoverstring
annual_turnover_fystring
percentage_in_cash_fystring
percentage_in_cashstring
aadhaar_validationstring
aadhaar_validation_datestring
address_detailsobject
gstinstring
pan_numberstring
business_namestring
legal_namestring
center_jurisdictionstring
state_jurisdictionstring
date_of_registrationstring
constitution_of_businessstring
taxpayer_typestring
gstin_statusstring
date_of_cancellationstring
field_visit_conductedstring
nature_bus_activitiesstring[]
nature_of_core_business_activity_codestring
nature_of_core_business_activity_descriptionstring
filing_statusarray[]
addressstring
hsn_infoobject
filing_frequencystring[]
detailstring
detailstring
detailstring
detailstring
detailstring
detailstring
detailstring
detailstring
codeinteger
timestampinteger
transaction_idstring
messagestring
detailstring
Overview
The GST Advanced Verification API provides a comprehensive GSTIN profile by pulling detailed registration, compliance, and financial data from the GST Portal. It goes beyond basic validation to deliver the depth of information needed for vendor due diligence, credit risk assessment, and regulatory audits.
The API accepts a single required parameter: a 15-character alphanumeric GSTIN.
When to use GST Advanced
Use GST Advanced when you need detailed compliance and financial data beyond basic registration status. Common scenarios include:
- Vendor due diligence — assess filing compliance, business activity, and promoter details before onboarding a supplier
- Credit underwriting — evaluate annual turnover and filing regularity as part of lending decisions
- Regulatory audits — pull complete GSTIN profiles with filing records across multiple return types
- Supply chain compliance — verify HSN codes and business activities match declared trade
If you only need to confirm a GSTIN is valid and active, use the faster GST Basic Verification instead.
Fields returned
The GST Advanced API returns everything in GST Basic, plus detailed compliance and financial data:
| Field | In Basic | In Advanced | Description |
|---|---|---|---|
| Legal name | Yes | Yes | Registered legal name |
| Trade name | Yes | Yes | Trading name / brand name |
| Registration date | Yes | Yes | Date the GSTIN was registered |
| Status | Yes | Yes | Active, cancelled, or suspended |
| Business type | Yes | Yes | Constitution (Proprietorship, LLP, etc.) |
| Taxpayer type | Yes | Yes | Regular, Composition, or ISD |
| State jurisdiction | Yes | Yes | State and center jurisdiction codes |
| Principal address | No | Yes | Full registered address with pincode |
| Additional addresses | No | Yes | Branch or warehouse addresses |
| Contact details | No | Yes | Email addresses and phone numbers |
| Promoter / director names | No | Yes | Names of business promoters |
| Annual turnover slab | No | Yes | Declared turnover range and fiscal year |
| Cash transaction percentage | No | Yes | Percentage of cash transactions reported |
| Aadhaar validation status | No | Yes | Whether Aadhaar verification is complete |
| HSN codes | No | Yes | Core business activity codes and descriptions |
| Filing history (GSTR-1) | No | Yes | Sales return filing dates and status |
| Filing history (GSTR-3B) | No | Yes | Summary return filing dates and status |
| Filing history (GSTR-9) | No | Yes | Annual return filing records |
| Filing history (GSTR-9C) | No | Yes | Audit report filing records |
| Field inspection status | No | Yes | Whether a physical inspection was completed |
| Cancellation date | No | Yes | Date of cancellation, if applicable |
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.
Was this page helpful?
Last updated 4 weeks ago
Built with Documentation.AI