Skip to main content
POST
/
v2
/
verification
/
gst-certificate
Verify GST Certificate
curl --request POST \
  --url https://bgv.konnectnxt.com/api/v2/verification/gst-certificate/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "gstin": "27AABCI6363G1ZJ",
  "filing_details": true,
  "e_invoice_details": true
}
'
{
  "status": "success",
  "code": 200,
  "message": "Operation completed successfully",
  "data": {
    "gstin": "27AABCI6363G1ZJ",
    "gstinStatus": "Active",
    "verificationStatus": "VERIFIED",
    "legalName": "SAMPLE COMPANY PRIVATE LIMITED",
    "tradeName": "SAMPLE COMPANY",
    "dateOfRegistration": "2017-07-01",
    "dateOfCancellation": "",
    "constitutionOfBusiness": "Private Limited Company",
    "taxpayerType": "Regular",
    "isSez": false,
    "eInvoiceStatus": "ACT",
    "lastUpdatedDate": "2025-12-19",
    "centreJurisdiction": "RANGE-IV",
    "centreJurisdictionCode": "VU0404",
    "stateJurisdictionCode": "MHCG0491",
    "natureOfBusinessActivity": [
      "Office / Sale Office",
      "Warehouse / Depot",
      "Supplier of Services"
    ],
    "principalPlaceOfBusiness": {
      "nature": "Office / Sale Office",
      "address": {
        "buildingName": "Example Building",
        "doorNumber": "123",
        "floorNumber": "2nd Floor",
        "street": "Main Street",
        "location": "Business District",
        "city": "Mumbai",
        "district": "Mumbai Suburban",
        "stateName": "Maharashtra",
        "pincode": "400001",
        "latitude": "",
        "longitude": ""
      }
    },
    "additionalPlaceOfBusiness": null,
    "filingDetails": {
      "gstr1": [
        {
          "financialYear": "2025-2026",
          "taxPeriod": "December",
          "dateOfFiling": "2026-01-10",
          "status": "Filed"
        },
        {
          "financialYear": "2025-2026",
          "taxPeriod": "November",
          "dateOfFiling": "2025-12-11",
          "status": "Filed"
        }
      ],
      "gstr3b": [
        {
          "financialYear": "2025-2026",
          "taxPeriod": "December",
          "dateOfFiling": "2026-01-20",
          "status": "Filed"
        },
        {
          "financialYear": "2025-2026",
          "taxPeriod": "November",
          "dateOfFiling": "2025-12-20",
          "status": "Filed"
        }
      ]
    }
  },
  "credits_used": 10,
  "credits_remaining": 984106.5
}

​
Overview

The GST Certificate Verification API provides comprehensive GST information by verifying the GSTIN directly against government records. Unlike document parsing, this API fetches real-time data including business details, filing history, and compliance status.

​
Key Features

  • Real-time Verification: Fetches live data from GST portal
  • Complete Business Details: Legal name, trade name, registration dates
  • Filing History: GSTR-1 and GSTR-3B filing records
  • E-Invoice Status: Check e-invoice applicability
  • Address Information: Principal and additional business locations

​
GSTIN Validation

​
Format Requirements

A valid GSTIN must follow this structure:
  • Position 1-2: State code (27 = Maharashtra)
  • Position 3-12: PAN of the business (AABCI6363G)
  • Position 13: Entity number (1 = First registration)
  • Position 14: Default alphabet ‘Z’
  • Position 15: Check digit (J)
Example: 27AABCI6363G1ZJ

​
Valid State Codes

Code RangeStates/UTs
01-19Jammu & Kashmir to West Bengal
20-37Jharkhand to Andhra Pradesh
38Ladakh
97Other Territory
Note: Code 25 is not used (reserved) Check Detailed State Codes

​
Validation Errors

Common validation errors include:
  • Invalid Length: GSTIN must be exactly 15 characters
  • Invalid State Code: First 2 digits must be a valid Indian state/UT code
  • Invalid Format: Must match the required pattern
  • Invalid Characters: Only alphanumeric characters allowed

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
gstin
string
required

GST Identification Number (15 characters: 2 digits state code + 10 characters PAN + 3 characters entity/check digit)

Required string length: 15
Pattern: ^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z]{1}[1-9A-Z]{1}Z[0-9A-Z]{1}$
Example:

"27AABCI6363G1ZJ"

​
filing_details
boolean
default:true

Whether to include GSTR-1 and GSTR-3B filing history

Example:

true

​
e_invoice_details
boolean
default:true

Whether to include e-invoice status details

Example:

true

Response

GST certificate verified successfully

​
status
enum<string>
required

Overall status of the API

Available options:
success,
error
​
code
integer
required

HTTP status code

Example:

400

​
message
string
required

Description of the response or error

Example:

"Invalid request parameters"

​
data
object
required
​
credits_used
integer
required

Represents the total number of credits used in this request.

Example:

3

​
credits_left
integer
required

Represents the remaining credits available for use.

Example:

4040