GST Verification API
Verify any GSTIN number across India. Retrieve legal name, trade name, taxpayer status (Active/Cancelled), registration date, and state jurisdiction instantly.
POST /api/v1/gstin_info
~<500ms Avg Latency
99.9% Uptime SLA
x-api-key Auth
API Overview
Validate 15-digit GSTIN number, legal business name, trade name, and GST status.
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 |
|---|---|---|
| Gstin* | string | 15-character valid Indian GSTIN number (e.g. 27AAAAA0000A1Z5). |
Request & Response Examples
Sample Request:
HTTP POST /api/v1/gstin_info
POST /api/v1/gstin_info
x-api-key: your_api_key_here
Content-Type: application/json
{
"Gstin": "07AAAAA0000A1Z5"
}
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": "07AAAAA0000A1Z5",
"legal_Name": "ABC TRADERS PVT LTD",
"trade_Name": "ABC TRADERS",
"gst_Status": "Active",
"taxpayer_Type": "Regular",
"registration_Date": "01/07/2017"
}
}
Business Use Cases
1
B2B Vendor Onboarding
Designed for mission-critical workflows requiring verified real-time data lookups.
2
Invoice Verification
Designed for mission-critical workflows requiring verified real-time data lookups.
3
Tax Compliance
Designed for mission-critical workflows requiring verified real-time data lookups.
4
Credit Risk Assessment
Designed for mission-critical workflows requiring verified real-time data lookups.
Integration Steps
1
1. Pass x-api-key in header
2
2. Send 15-digit GSTIN number
3