GSTGST Basic

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"
{
  "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"
  }
}
GET
/v1/verification/gstinlite
GET
Bearer Token (JWT)
Bearer Tokenstring
Required

ACCESS_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
Required

The 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
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

Responses

codeinteger
timestampinteger
transaction_idstring
dataobject

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

FieldIncludedDescription
Legal nameYesRegistered legal name of the business
Trade nameYesTrading name / brand name
Registration dateYesDate the GSTIN was registered
StatusYesActive, cancelled, or suspended
Business typeYesConstitution of business (e.g., Proprietorship, LLP)
Taxpayer typeYesRegular, Composition, or Input Service Distributor
State jurisdictionYesState and center jurisdiction codes
Principal addressNoUse GST Advanced
Filing historyNoUse GST Advanced
HSN codesNoUse GST Advanced
Promoter detailsNoUse GST Advanced
Annual turnoverNoUse GST Advanced

GST Basic vs GST Advanced

One Access Token is valid for 24 hours. After expiry, renew it using the Authorization endpoint.