KwikID DocumentationShop and Establishment Verification
Verifies Shop and Establishment registration details using the KwikID API.
Shop and Establishment Verification
API reference
Try itLoading playground…
Loading…
AuthorizationBearer <token>
JWT Bearer token authentication. Obtain a token from the KwikID dashboard.
In: header
registrationNumberstring
The registration identifier of the shop.
statestring
The state of registration (e.g. 'Delhi').
Response Body
curl -X POST "https://__playground__/verification/v3/shop/shop_establishment" \ -H "Content-Type: application/json" \ -d '{ "registrationNumber": "20***485", "state": "Delhi" }'{
"success": true,
"status_code": 200,
"provider": "KwikID",
"api_name": "Shop and Establishment",
"data": {
"result": {
"establishmentName": "ABC ENTERPRISES",
"registrationNumber": "20***485",
"dateOfCommencement": "02/01/2017",
"status": "ACTIVE",
"address": "JJ COLONY WAZIRPUR DELHI, DELHI. PIN-XXXXXX, CONTACT NO 999999999 22222222, FAX",
"category": "COMMERCIAL ESTABLISHMENT"
}
}
}{
"detail": {},
"message": "string"
}{
"error": "string"
}Overview
Call POST /verification/v3/shop/shop_establishment from your backend when you need to verify Shop and Establishment registration details. This API interfaces with the KwikID gateway.
Key features
- Real-time verification: Connects directly to local municipal/state registration databases via KwikID.
- Detailed split address: Returns structured address lines, pin codes, city, state, and country.
- Robust error handling: Handles invalid credentials and downstream network timeouts gracefully.
Implementation
Step 1: Call from your backend
POST /verification/v3/shop/shop_establishment HTTP/1.1
Host: <verification-api-base-url>
Authorization: Bearer <token>
Content-Type: application/json
{
"registrationNumber": "20***485",
"state": "Delhi"
}Step 2: Use the response
On success (200 OK), the response will return detailed establishment metadata:
{
"success": true,
"status_code": 200,
"provider": "KwikID",
"api_name": "Shop and Establishment",
"data": {
"result": {
"establishmentName": "ABC ENTERPRISES",
"registrationNumber": "20***485",
"dateOfCommencement": "02/01/2017",
"status": "ACTIVE",
"address": "JJ COLONY WAZIRPUR DELHI, DELHI. PIN-XXXXXX, CONTACT NO 999999999 22222222, FAX",
"category": "COMMERCIAL ESTABLISHMENT"
}
}
}