Skip to main content
POST
Verify GST Certificate

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

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

API key issued by KonnectNXT. Pass as Authorization: Bearer <your_api_key>.

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