GST Verification with Promoters API
Verify any GSTIN number across India with comprehensive promoter details. Retrieve legal name, trade name, taxpayer status, address, registration date, and all associated business owners, partners, and directors instantly.
POST /api/v1/gst_promoters
~<500ms Avg Latency
99.9% Uptime SLA
x-api-key Auth
API Overview
Validate 15-digit GSTIN number, legal business name, trade name, GST status, and complete list of business owners/promoters/directors.
Key Features & Data Points:
- Instant Authoritative Response: Fetches verified official data with ultra-low response latency (~<500ms).
- Clean JSON Standard: Normalized structure across all verification services for effortless enterprise integration.
- Enterprise SLA: Backed by NextStepApi 99.9% uptime architecture and redundant provider failover.
- Secure Header Authentication: Direct authentication via
x-api-keyrequest header.
Request Specification
Headers:
| Header Name | Type | Description |
|---|---|---|
| x-api-key* | string | Your secret production API Key obtained from your NextStepApi dashboard. |
| Content-Type* | string | Must be set to application/json. |
| x-request-id | string | Optional client-generated tracking ID (e.g. REQ12345XYZ) for idempotent logging. |
Request Body (JSON):
| Parameter | Type | Description |
|---|---|---|
| request_payload* | object | JSON object containing verification parameters. |
Request & Response Examples
Sample Request:
HTTP POST /api/v1/gst_promoters
POST /api/v1/gst_promoters
x-api-key: your_api_key_here
Content-Type: application/json
{\"gstin\": \"27AAAAA0000A1Z5\"}
Sample Response (200 OK — Sanitized Test Data):
HTTP 200 OK • application/json • <500ms
{
"code": 200,
"status": "success",
"message": "Success",
"request_id": "REQ12345",
"response": {
"request_id": "REQ12345",
"gstin": "27AAAAA0000A1Z5",
"legal_name": "ACME SOLUTIONS PRIVATE LIMITED",
"trade_name": "ACME SOLUTIONS PRIVATE LIMITED",
"promoters": [
"RAJESH KUMAR",
"PRIYA SHARMA"
],
"taxpayer_type": "REGULAR",
"reg_date": "08-05-2024",
"state_code": "RJ008",
"nature": "Supplier of Services",
"jurisdiction": "GST RANGE-XXVI",
"business_type": "PRIVATE LIMITED COMPANY",
"last_update": null,
"address": {
"addr1": "4TH FLOOR",
"addr2": "PLOT NO. 101, TECH PARK, BANDRA KURLA COMPLEX",
"pin": "400051",
"state": "Rajasthan",
"city": "Jaipur",
"district": "Jaipur"
},
"status": "Active"
},
"timestamp": "2026-10-04T15:37:00.000Z"
}
Business Use Cases
1
Digital Customer Onboarding & Identity Verification
Designed for mission-critical workflows requiring verified real-time data lookups.
2
Enterprise Vendor Due Diligence & Risk Management
Designed for mission-critical workflows requiring verified real-time data lookups.
3
Regulatory Compliance & Real-time Fraud Prevention
Designed for mission-critical workflows requiring verified real-time data lookups.
Integration Steps
1
Pass x-api-key in the request header
2
Construct HTTP POST request with required JSON payload
3