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
""Format
stringResponse 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 status | When |
|---|---|
| 400 | Validation error. |
| 401 | Invalid Bearer token. |
Benefits
- Confirms GST registration context for B2B onboarding.