Business & GST Verification APIs

GST Advanced Verification API

Everything in GST Verification plus the aggregate turnover slab, gross total income, e-invoice mandate, members or directors and every business place.

What it verifies

Everything in GST Verification, plus the aggregate annual turnover slab, gross total income, the e-invoice mandate, the members or directors of the entity and every place of business. The GST certificate link and the return filing frequency are included only when Digitap has switched them on for the account.

Who uses it

Lenders sizing a business borrower by turnover slab and filing behaviour
Marketplaces and procurement teams doing deeper due diligence on a supplier
Risk and compliance teams who need the directors and every place of business behind a GSTIN

Request and response

POSThttps://verification.techinnoverz.com/api/v1/business-gst/gst-advanced

Verify a GSTIN and get its turnover slab, directors and business places as well. This call is billed when it returns a successful result.

Request body

gstinstringrequired

The 15-character GSTIN to verify.

consentstringrequired

Must be "Y". Records that the end customer consented to this check; logged against the transaction.

referenceIdstringoptional

Your own id, echoed back in the response for reconciliation.

Example requests

curl -X POST "https://verification.techinnoverz.com/api/v1/business-gst/gst-advanced" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "gstin": "29ABCPE1234F1Z5",
  "consent": "Y",
  "referenceId": "app_20915"
}'

const res = await fetch("https://verification.techinnoverz.com/api/v1/business-gst/gst-advanced", {
  method: "POST",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "gstin": "29ABCPE1234F1Z5",
    "consent": "Y",
    "referenceId": "app_20915"
  }),
});
const result = await res.json();

import requests

res = requests.post(
    "https://verification.techinnoverz.com/api/v1/business-gst/gst-advanced",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "gstin": "29ABCPE1234F1Z5",
        "consent": "Y",
        "referenceId": "app_20915",
    },
    timeout=15,
)
result = res.json()

200 response — status "found"

Response

{
  "status": "found",
  "data": {
    "gstin": "29ABCPE1234F1Z5",
    "tradeName": "Sample Traders",
    "legalName": "Asha Sample",
    "constitutionOfBusiness": "Proprietorship",
    "status": "Active",
    "taxpayerType": "Regular",
    "natureOfCoreBusiness": "MFT",
    "registrationDate": "14/12/2018",
    "cancellationDate": null,
    "natureOfBusinessActivities": [
      "Factory / Manufacturing",
      "Retail Business"
    ],
    "principalPlaceAddress": "1-28, Main Road, Vijayawada, Andhra Pradesh, 521111",
    "ekycVerified": "No",
    "aadhaarVerified": "No",
    "complianceRating": "NA",
    "fieldVisitConducted": "No",
    "stateJurisdiction": "State - Andhra Pradesh,Division - Vijayawada I,Circle - NUZIVEEDU",
    "centralJurisdiction": "Commissionerate - GUNTUR,Division - VIJAYAWADA,Range - HANUMAN E",
    "eInvoiceStatus": "Yes",
    "aadhaarValidationDate": "01/01/2022",
    "eInvoiceMandated": "Yes",
    "aggregateTurnoverSlab": "Slab: Rs. 5 Cr. to 25 Cr.",
    "aggregateTurnoverSlabFinancialYear": "2021-2022",
    "grossTotalIncome": "Not Available",
    "grossTotalIncomeFinancialYear": "2019-2020",
    "percentTaxInCash": "NA",
    "percentTaxInCashFinancialYear": null,
    "complianceDetailsAvailable": false,
    "membersOrDirectors": [
      "Asha Sample",
      "Ravi Example"
    ],
    "returns": [
      {
        "financialYear": "2020-2021",
        "taxPeriod": "February",
        "modeOfFiling": "ONLINE",
        "dateOfFiling": "11/03/2021",
        "returnType": "GSTR1",
        "arn": "NA",
        "status": "Filed"
      }
    ],
    "goods": [
      {
        "description": "Cotton fabric",
        "hsnCode": "55151190"
      }
    ],
    "services": [
      {
        "description": "BUSINESS SUPPORT SERVICES",
        "sacCode": "00440366"
      }
    ],
    "principalPlace": {
      "address": "1-28, Main Road, Vijayawada",
      "addressDetail": "1-28 Main Road",
      "natureOfBusiness": "Factory / Manufacturing",
      "lastUpdatedDate": "01/02/2020"
    },
    "additionalPlaces": [
      {
        "address": "Plot 4, Vijayawada",
        "addressDetail": "Plot 4",
        "natureOfBusiness": "Warehouse / Depot",
        "lastUpdatedDate": "03/04/2021",
        "email": "unit@example.com",
        "mobile": "9876543210"
      }
    ],
    "certificatePdfUrl": null,
    "returnFilingFrequency": [
      {
        "financialYear": "2024-25",
        "quarter": "Jan-Mar",
        "frequency": "Monthly"
      }
    ]
  },
  "source": "provider",
  "dataAsOf": "2026-11-03T09:30:00.000Z",
  "referenceId": "app_20915",
  "billing": {
    "charged": true,
    "walletBalance": "12450.00"
  },
  "txnId": "txn_8c31ba90",
  "livemode": true
}

Fields returned in data

gstinstringoptional

The GSTIN that was verified.

tradeNamestringoptional

Trade name of the business. null when not held.

legalNamestringoptional

Legal name of the business or individual the GSTIN belongs to.

constitutionOfBusinessstringoptional

Constitution of the business: proprietorship, partnership, private limited company and so on.

statusstringoptional

Current status of the registration under GST, for example Active or Cancelled. A cancelled GSTIN is still returned, with this status.

taxpayerTypestringoptional

Taxpayer type, for example Regular or Composition.

natureOfCoreBusinessstringoptional

Nature of core business in short form: MFT manufacturer, SPO service provider and others, TRD:TRR trader (retailer), TRD:TWD trader (wholesale distributor).

registrationDatestringoptional

Registration date under GST, as the source gives it (DD/MM/YYYY).

cancellationDatestringoptional

Date the registration was cancelled, as the source gives it. null when it has not been.

natureOfBusinessActivitiesarrayoptional

Nature of business activities registered under GST.

principalPlaceAddressstringoptional

Complete address of the principal place of business.

ekycVerifiedstringoptional

e-KYC verification status: Yes, No or NA.

aadhaarVerifiedstringoptional

Aadhaar verification status: Yes, No or NA.

complianceRatingstringoptional

Compliance rating, when the GST network provides one: Yes, No or NA.

fieldVisitConductedstringoptional

Whether a field visit was conducted: Yes, No or NA.

stateJurisdictionstringoptional

State jurisdiction of the registration.

centralJurisdictionstringoptional

Central jurisdiction of the registration.

eInvoiceStatusstringoptional

Whether e-invoicing is enabled for the business: Yes or No.

aadhaarValidationDatestringoptional

Aadhaar validation date, as the source gives it.

eInvoiceMandatedstringoptional

Whether e-invoicing is mandatory for the business: Yes or No.

aggregateTurnoverSlabstringoptional

Aggregate annual turnover slab, for example Slab: Rs. 5 Cr. to 25 Cr.

aggregateTurnoverSlabFinancialYearstringoptional

The financial year the aggregate turnover slab is for.

grossTotalIncomestringoptional

Gross total income as per income-tax returns, when available.

grossTotalIncomeFinancialYearstringoptional

The financial year the gross total income is for.

percentTaxInCashstringoptional

Percentage of tax paid in cash. null when not given.

percentTaxInCashFinancialYearstringoptional

Percentage of tax paid in cash for the financial year. null when not given.

complianceDetailsAvailablebooleanoptional

Whether compliance details are available.

membersOrDirectorsarrayoptional

Members or directors of the entity.

returnsarrayoptional

Recent return filings: financial year, tax period, mode and date of filing, return type, ARN and filing status.

goodsarrayoptional

Goods the business has registered, each with a description and an HSN code.

servicesarrayoptional

Services the business has registered, each with a description and a SAC code.

principalPlaceobjectoptional

The principal place of business: address, address detail, nature of business and the date the address was last updated.

additionalPlacesarrayoptional

Other places of business, each with an address, email, mobile, nature of business and the date it was last updated.

certificatePdfUrlstringoptional

A link to the GST certificate PDF, valid for 7 days. null unless Digitap has switched this on for the account.

returnFilingFrequencyarrayoptional

How often GST returns are filed, by financial year and quarter. Empty unless Digitap has switched this on for the account.

Error codes

Errors return a non-200 HTTP status and the same envelope, so your retry logic and your reconciliation agree.

400 INVALID_INPUT

A field is missing or malformed. The details list each problem. Not charged.

401 INVALID_KEY

The key is missing, revoked, or not a key we issued.

402 WALLET_EMPTY

Your available balance is below the price of this call. Top up and retry. Not charged.

403 PRODUCTION_NOT_ENABLED

A live key was used before live access was enabled for your account. Use a test key, or ask us to enable live access.

403 TEST_NOT_ENABLED

A test key was used before test (UAT) access was enabled for your account. Ask us to enable it.

403 API_NOT_ENABLED

This check is switched off for your account, or is not available for live use yet.

403 IP_NOT_ALLOWED

The key is restricted to certain IP addresses and this call came from another.

403 ACCOUNT_SUSPENDED

The account is suspended. Contact support.

404 NO_DATA

A valid request, but no record was found. Not charged.

404 ROUTE_NOT_FOUND

There is no endpoint at that path.

405 METHOD_NOT_ALLOWED

Use the method shown in the Allow header.

409 IDEMPOTENCY_IN_PROGRESS

A call with the same Idempotency-Key is still being processed. Retry after the delay in Retry-After.

413 PAYLOAD_TOO_LARGE

The request body is too large. Not charged.

415 UNSUPPORTED_MEDIA_TYPE

Send the request with Content-Type: application/json.

422 IDEMPOTENCY_KEY_REUSED

This Idempotency-Key was already used with a different request body. Use a new key for a new request.

429 RATE_LIMITED

Too many requests or too many at once. Wait for the Retry-After delay.

500 INTERNAL_ERROR

Something went wrong on our side. Not charged. Quote the txnId if you contact support.

502 SOURCE_ERROR

The data source returned an error. Not charged.

503 SOURCE_DOWN

The data source is unavailable right now. Not charged. Retry after the delay in Retry-After.

504 SOURCE_TIMEOUT

The data source did not answer in time. Not charged.

Error response

{
  "status": "error",
  "error": {
    "code": "NO_DATA",
    "message": "No record found for the given input. Not charged."
  },
  "billing": {
    "charged": false
  },
  "txnId": "txn_8c31ba91",
  "livemode": true
}

Billing

You are charged only on successful hits. Failed, no-data and error calls are free.

Every response carries billing.charged and your remaining billing.walletBalance. Per-hit pricing is set on your rate card; book a demo to get yours.

Related checks

GST Verification API — Verify a GSTIN and get the business's legal and trade name, status, address, recent return filings and registered goods and services.
Udyam Verification API — Verify a Udyam registration number and return enterprise profile, address, industries and classification history.
PAN to Udyam API — Look up the Udyam registration linked to a business PAN, with enterprise details and certificate PDF when held.
Mobile to Udyam API — List Udyam registration numbers linked to a mobile number, without an OTP step.

All API documentation · OpenAPI specification · Docs as plain text