Skip to main content
GET
/
gst
/
status
Fetch GST Verification Status
curl --request GET \
  --url https://bgv.konnectnxt.com/api/gst/status \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "code": 123,
  "message": "<string>",
  "data": {
    "gstin": "36ABBCS2941P1ZX",
    "legal_name": "SUSTENANCE'S GROWTH CULTIVATION PRIVATE LIMITED",
    "trade_name": "SUSTENANCE'S GROWTH CULTIVATION PRIVATE LIMITED",
    "status": "Active",
    "is_active": true,
    "constitution": "Private Limited Company",
    "registration_date": "2019-03-01T00:00:00.000Z",
    "cancellation_date": null,
    "business_nature": [
      "<string>"
    ],
    "is_sez": false,
    "turnover": {
      "slab": "Slab: Rs. 0 to 40 lakhs",
      "financial_year": "2024-2025"
    },
    "principal_address": {
      "address": "<string>",
      "pincode": "<string>",
      "state": "<string>",
      "district": "<string>"
    },
    "jurisdiction": {
      "center": "<string>",
      "center_code": "<string>",
      "state_code": "<string>"
    },
    "filing_summary": {
      "gstr1_filed_count": 123,
      "gstr3b_filed_count": 123,
      "last_gstr1_filed_on": "2023-12-25",
      "last_gstr3b_filed_on": "2023-12-25"
    },
    "hsn_codes": [
      {
        "hsn_code": "<string>",
        "hsn_description": "<string>",
        "type": "service"
      }
    ],
    "promoters": [
      "<string>"
    ],
    "source": "GSP",
    "last_updated": "2024-07-26T00:00:00.000Z"
  }
}

​
Overview

The GST Verification – Status API is used to fetch the final verification result of a GSTIN using the request_id generated by the GST Verification – Initiate API. This endpoint returns detailed and authoritative information about the GST registration, including legal entity details, registration status, filing history, jurisdiction, business nature, and other compliance-related metadata. This API is intended to be called after a verification request has been successfully initiated. It completes the asynchronous verification workflow by providing the verified GST data once processing is finished.

​
Workflow Context

  1. Call GST Verification – Initiate API with a valid GSTIN.
  2. Store the returned request_id.
  3. Call GST Verification – Status API using the request_id to retrieve the verification result.
If the verification is still in progress or failed, the API response will reflect the appropriate status or error message.

​
Important Notes

  • This API must be called only after initiating GST verification.
  • The request_id is mandatory and uniquely identifies the verification request.
  • Data returned is sourced from authorized GST service providers (GSPs).
  • The response represents the latest available GST information at the time of verification.
  • Field availability may vary depending on the GSTIN and data source.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
request_id
string<uuid>
required

Request ID received from the initiate API.

Response

GST verification success response .

​
status
enum<string>
required

Overall status of the API

Available options:
success,
error
​
code
integer
required

HTTP status code

​
message
string
required

Description of the response or error

​
data
object
required