Status

Fetch GST Verification Status

curl --request GET \
  --url https://bgv.konnectnxt.com/api/gst/status \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://bgv.konnectnxt.com/api/gst/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bgv.konnectnxt.com/api/gst/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://bgv.konnectnxt.com/api/gst/status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://bgv.konnectnxt.com/api/gst/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "code": 400,
  "message": "Invalid request parameters",
  "data": {
    "gstin": "27AABCI6363G1ZJ",
    "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"
  }
}

GET

gst

status

Fetch GST Verification Status

curl --request GET \
  --url https://bgv.konnectnxt.com/api/gst/status \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://bgv.konnectnxt.com/api/gst/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bgv.konnectnxt.com/api/gst/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://bgv.konnectnxt.com/api/gst/status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://bgv.konnectnxt.com/api/gst/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "code": 400,
  "message": "Invalid request parameters",
  "data": {
    "gstin": "27AABCI6363G1ZJ",
    "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

Call GST Verification – Initiate API with a valid GSTIN.
Store the returned request_id.
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

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

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

Example:

400

message

string

required

Description of the response or error

Example:

"Invalid request parameters"

data

object

required

Show child attributes

API Documentation

Background Verification

Lookup APIs

Financial APIs

Vehicle APIs

OCR APIs

Masking APIs

Validation

Business Verification

Document E-Sign

Global DB

Credits

Overview

Workflow Context

Important Notes

Authorizations

Query Parameters

Response

​Overview

​Workflow Context

​Important Notes

Authorizations

Query Parameters

Response

Overview

Workflow Context

Important Notes