BrandKwikID Documentation
API SuiteBusiness Verification (GST, Udyam, Udyog)

GST Details

Fetch GST registration details for a GSTIN. Server-side POST with Bearer auth; GSTIN goes in the path.

API reference

Try itLoading playground…
Loading…
AuthorizationBearer <token>

JWT Bearer token authentication. Obtain a token from the KwikID dashboard.

In: header

Path Parameters

gst_inunknown

The GST number for which data has to be fetched.

Default""
Formatstring

Response Body

curl -X POST "https://__mock__/verification/v2/gst/get//"
{
  "message": "string"
}
{
  "detail": {
    "<location>": {
      "<field_name>": [
        "string"
      ]
    }
  },
  "message": "string"
}
{
  "detail": {},
  "message": "string"
}

Overview

Call POST /verification/v2/gst/get/{gst_in}/ from your backend with Authorization: Bearer <token>. Replace {gst_in} in the path with the 15-character GSTIN (URL-encode if your client requires it). The request body is typically empty unless OpenAPI lists fields for your tenant.

Key features

  • Direct GSTIN pull when you already know the registration number.
  • Pairs with PAN discovery: Use GST Details from PAN when you only hold PAN first.

Implementation

Step 1: Call from your backend

POST /verification/v2/gst/get/27AABCU9603R1Z0/ HTTP/1.1
Host: <verification-api-base-url>
Authorization: Bearer <token>
Content-Type: application/json

{}

Step 2: Use the response

Read message and any expanded business fields returned for your environment.

Error handling

HTTP statusWhen
400Validation error.
401Invalid Bearer token.

Benefits

  • Confirms GST registration context for B2B onboarding.

Next steps