GST Verification API

Integrate live GSTIN verification into your application. Simple REST API, JSON responses, prepaid credits.

⚡ 10 paise/lookup 🎁 10 free demo calls 🔑 API key auth 📦 JSON response
Get API Key →
🔑

Sign in to Get Your API Key

Get 10 free calls instantly. No credit card required.

Continue with Google
Pay-as-you-go Packs
Demo
Free
10 calls
10 free calls included
✓ Included with API key
Starter
₹100
1,000 calls
₹0.10/call
Sign in →
Growth
₹450
5,000 calls
₹0.09/call · 10% off
Sign in →
Scale
₹1600
20,000 calls
₹0.08/call · 20% off
Sign in →
Unlimited API Plans
Monthly
₹5,000
Unlimited calls
Flat rate · No per-call fee · 120 req/min
Sign in to Subscribe →
Annual Save 50%
₹30,000
Unlimited calls/year
₹2,500/month effective · 120 req/min
Sign in to Subscribe →
API Documentation
GET /api/v1/verify/{GSTIN}

Verify a single GSTIN. Returns registration details, status, address, and filing info.

Request
curl -H "X-API-Key: YOUR_API_KEY" \ "https://gstverify.co.in/api/v1/verify/27AAAAA0000A1Z5"
Response
{ "success": true, "cached": false, "credits_remaining": 99, "data": { "gstin": "27AAAAA0000A1Z5", "legal_name": "EXAMPLE COMPANY PRIVATE LIMITED", "trade_name": "Example Co", "status": "Active", "constitution": "Private Limited Company", "taxpayer_type": "Regular", "registration_date": "01/07/2017", "state": "Maharashtra", "pan": "AAAAA0000A", "address": "123 Business Park, Mumbai — 400001", "nature_of_business": ["Supplier of Services"] } }
GET /api/v1/health-score/{GSTIN} 1 credit

Compliance trust score (0–100) — the same algorithm behind our free GST Health Score checker, as an API. Weighs registration status, filing recency, entity age, and taxpayer type.

Request
curl -H "X-API-Key: YOUR_API_KEY" \ "https://gstverify.co.in/api/v1/health-score/27AAAAA0000A1Z5"
Response
{ "success": true, "gstin": "27AAAAA0000A1Z5", "legal_name": "EXAMPLE COMPANY PRIVATE LIMITED", "data": { "score": 82, "rating": "Excellent", "summary": "This GSTIN shows excellent compliance indicators...", "factors": [ { "label": "Registration Status", "pts": 50, "max": 50, "note": "Active — GSTIN is valid..." } ] }, "credits_remaining": 98 }
GET /api/v1/risk-score/{GSTIN} 2 credits

Vendor risk score (0–100, higher = safer) purpose-built for procurement/vendor-onboarding decisions — weighted toward filing consistency over the past year, entity maturity, and taxpayer type, not just a compliance snapshot.

Request
curl -H "X-API-Key: YOUR_API_KEY" \ "https://gstverify.co.in/api/v1/risk-score/27AAAAA0000A1Z5"
Response
{ "success": true, "gstin": "27AAAAA0000A1Z5", "data": { "score": 78, "level": "Low Risk", "recommendation": "Standard onboarding — no elevated vendor risk indicators.", "signals": [ "..." ] }, "credits_remaining": 96 }
GET /api/v1/filing/{GSTIN}?financial_year=2025-26 1 credit

Structured GSTR filing history for a financial year — per-period, per-return-type filing status plus a compliance % (returns filed ÷ returns expected). financial_year is optional and defaults to the current FY.

Request
curl -H "X-API-Key: YOUR_API_KEY" \ "https://gstverify.co.in/api/v1/filing/27AAAAA0000A1Z5?financial_year=2025-26"
Response
{ "success": true, "gstin": "27AAAAA0000A1Z5", "data": { "financial_year": "2025-26", "compliance_percent": 92, "total_expected": 24, "total_filed": 22, "periods": [ { "return_period": "062025", "returns": [ { "return_type": "GSTR3B", "date_of_filing": "20-07-2025", "status": "Filed" } ]} ] }, "credits_remaining": 95 }
Error Responses
Code Meaning
401 Missing or invalid API key
402 No credits remaining — recharge your account
422 Invalid GSTIN format
429 Rate limit exceeded (60 req/min)
502 Upstream GST API unavailable
Search API — PAN & Business Name Lookup
🔍 The Search API lets you find all GSTINs registered under a PAN number, or search businesses by name. Uses separate Search Credits — not the same as Verify credits.
GET /api/v1/search/pan/{PAN}

Find all GSTINs registered under a 10-character PAN. Returns live results from GSTN — discovers registrations not yet in local cache.

Request
curl -H "X-API-Key: YOUR_API_KEY" \ "https://gstverify.co.in/api/v1/search/pan/AAACR5055K"
Response
{ "success": true, "type": "pan", "query": "AAACR5055K", "count": 3, "source": "live", "credits_remaining": 49, "data": [ { "gstin": "27AAACR5055K1ZT", "legal_name": "RELIANCE INDUSTRIES LIMITED", "trade_name": "Reliance Industries", "status": "Active", "constitution": "Public Limited Company", "state": "Maharashtra", "state_code": "27", "pan": "AAACR5055K", "registration_date": "01/07/2017", "nature_of_business": ["Supplier of Services"] } ] }
GET /api/v1/search/name/{query}

Search businesses by name (minimum 3 characters). Returns matching GSTINs from live GSTN database. Searches both legal name and trade name.

Request
curl -H "X-API-Key: YOUR_API_KEY" \ "https://gstverify.co.in/api/v1/search/name/Reliance%20Industries"
Query Parameters Alternative
curl -H "X-API-Key: YOUR_API_KEY" \ "https://gstverify.co.in/api/v1/search?type=name&q=Reliance+Industries"
Search API Credits & Pricing
Demo
Free
10 searches
10 free with API key
✓ Auto-added with API key
Starter
₹99
100 searches
₹0.99/search
Sign in →
Growth
₹399
500 searches
₹0.80/search · 20% off
Sign in →
Scale
₹1399
2,000 searches
₹0.70/search · 30% off
Sign in →
Verify Credits vs Search Credits
Feature Verify Credits Search Credits
Endpoint /api/v1/verify/{GSTIN} /api/v1/search/pan or /name
Input 15-char GSTIN 10-char PAN or business name
Output 1 business record Multiple matching records
Cache Free on cache hit Always 1 credit (live GSTN call)
Rate limit 60/min 30/min
Price ₹0.10/live call ₹0.99–₹0.70/search
Expiry Never Never

Frequently Asked Questions

Sign in with Google, then click 'Generate API Key' on this page. You'll get 10 free demo calls instantly. The key is shown once — copy and store it securely.
Verify API: 10 paise (₹0.10) per GSTIN lookup. Search API: ₹0.70–₹0.99 per search depending on your pack size. Cache hits are always free.
No. Both Verify credits and Search credits never expire. Use them at your own pace.
Verify credits are for GSTIN lookups (/api/v1/verify/GSTIN). Search credits are for PAN-based and name-based searches (/api/v1/search/pan/PAN or /api/v1/search/name/query). They use separate credit pools.
JSON. Every response includes the GSTIN, legal name, trade name, registration status, entity type, address, filing history, and more. Full documentation is available above.
Free demo calls: 5 total. Paid credits: up to 100 requests per minute. API Monthly/Annual plans: unlimited calls with no rate limit.
Yes. Generate a key to get 5 free demo calls. Test with any valid GSTIN to see the full response structure.
The API returns a 402 (Payment Required) error. Buy more credits from this page or upgrade to an unlimited plan.