Skip to main content
POST
/
gst
/
initiate
Initiate GST Verification
curl --request POST \
  --url https://bgv.konnectnxt.com/api/gst/initiate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "gstin": "36AAGCN9336F1Z9"
}
'
{
  "status": "success",
  "code": 200,
  "message": "string",
  "data": {
    "request_id": "cbb66de8-83f3-47f9-90f5-4719340d2f39"
  },
  "credits_used": 3,
  "credits_left": 34
}

​
Overview

The GST Verification – Initiate API is used to start the verification process for a given GST Identification Number (GSTIN). This API validates the provided GSTIN and creates a verification request in the system. Upon successful initiation, the API returns a unique request_id which can be used to track and fetch the final verification result through the corresponding status or result API. This API is designed for asynchronous verification, meaning the verification process may take some time to complete. Clients are expected to store the returned request_id and query the verification status separately.

​
Use Cases

This API is commonly used in scenarios such as:
  • Business onboarding and KYC verification
  • Vendor or supplier validation
  • Background verification (BGV) workflows
  • Compliance and regulatory checks
  • Automated GST authenticity validation in enterprise systems

​
Important Notes

  • This API only initiates the GST verification process.
  • The actual verification result is not returned immediately.
  • Always store the returned request_id and use it with the GST Verification Status/Result API to retrieve the final verification details.
  • Credits are consumed only for valid initiation requests.
  • Ensure the GSTIN follows the standard 15-character format before making the request to avoid unnecessary failures.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
gstin
string
required

Valid 15-character GST Identification Number.

Example:

"36AAGCN9336F1Z9"

Response

GST verification successfully initiated.

​
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