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=27AABCL2345F1ZS" \
  -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=27AABCL2345F1ZS"
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=27AABCL2345F1ZS", {
  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=27AABCL2345F1ZS", 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=27AABCL2345F1ZS')
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": "Unit 501, BKC Business Park, Bandra Kurla Complex, Mumbai, Maharashtra, 400051",
        "email": "contact@lotusfintech.example",
        "mobile": "9876500010",
        "nature_of_business": "Office / Sale Office, Service Provision, Recipient of Goods or Services"
      },
      "additional": [
        {
          "address": "Level 8, Orchid Corporate Tower, Andheri East, Mumbai, Maharashtra, 400069",
          "email": "contact@lotusfintech.example",
          "mobile": "9876500010",
          "nature_of_business": "Office / Sale Office, Supplier of Services, Recipient of Goods or Services"
        }
      ]
    },
    "promoters": [
      "Abhijeet Rao",
      "Neha Kapoor"
    ],
    "annual_turnover": "Slab: Rs. 40 Cr. to 60 Cr.",
    "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": "27AABCL2345F1ZS",
    "pan_number": "AABCL2345F",
    "business_name": "Lotus Fintech Private Limited",
    "legal_name": "Lotus Fintech Private Limited",
    "center_jurisdiction": "State - CBIC,Zone - MUMBAI,Commissionerate - MUMBAI EAST,Division - DIVISION VII,Range - RANGE-I (Jurisdictional Office)",
    "state_jurisdiction": "State - Maharashtra,Division - DGSTO Mumbai, LOCAL GST Office - LGSTO 051 - Bandra Kurla",
    "date_of_registration": "2017-07-01",
    "constitution_of_business": "Private Limited Company",
    "taxpayer_type": "Regular",
    "gstin_status": "Active",
    "date_of_cancellation": "1800-01-01",
    "field_visit_conducted": "No",
    "nature_bus_activities": [
      "Office / Sale Office",
      "Service Provision",
      "Supplier of Services",
      "Recipient of Goods or Services"
    ],
    "nature_of_core_business_activity_code": "SPO",
    "nature_of_core_business_activity_description": "Service Provider",
    "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": []
  }
}

GET

/v1/verification/gstin-advanced

GET

Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token (JWT)

Bearer Tokenstring

Required

ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .

API Key (header: x-api-key)

x-api-keystring

Required

The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.

query

gstin_numberstring

Required

Request Preview

Response

Response will appear here after sending the request

Authentication

header

Authorizationstring

Required

Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .

header

x-api-keystring

Required

API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.

Query Parameters

gstin_numberstring

Required

Example:

27AABCL2345F1ZS

Responses

codeinteger

timestampinteger

transaction_idstring

sub_codestring

messagestring

dataobject

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?