Business API

GST Verification

Verify a 15-character GSTIN (Goods & Services Tax Identification Number) registered under India's GST system.

GST Verification
POST

GST Verification API — Verify a 15-character GSTIN (Goods & Services Tax Identification Number) registered under India's GST system. Critical for B2B vendor verification, invoice validation, and supply chain compliance. Returns the business legal name, trade name, registration status (Active, Cancelled, Suspended), taxpayer type, constitution (Private Limited, LLP, etc.), registration date, registered address with state and pincode, PAN number, nature of business activities, and e-invoice status. Use this endpoint to validate GST invoices, verify suppliers before onboarding, and ensure regulatory compliance under GST law.

  • Coverage: India
  • Real-time business lookup
  • Structured JSON response
  • POST request with Bearer auth
Get API Key — Free View Full Docs
Endpoint
POST
https://app.way2api.com/api/v1/gst/verify

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Parameters
Parameter Type Required Description
gst_number string Yes 15-character GSTIN — format: [0-9]{2}[A-Z]{5}[0-9]{4}[A-Z][0-9A-Z][Z][0-9A-Z] (e.g. 10AABCY0494J1ZF)
Request Example
<?php $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => "https://app.way2api.com/api/v1/gst/verify", CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json" ], CURLOPT_POSTFIELDS => json_encode([ "gst_number" => "10AABCY0494J1ZF" ]) ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode($response, true); print_r($data);
const response = await fetch("https://app.way2api.com/api/v1/gst/verify", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ "gst_number": "10AABCY0494J1ZF" }) }); if (!response.ok) { throw new Error(`HTTP error: ${response.status}`); } const data = await response.json(); console.log(data);
curl -X POST https://app.way2api.com/api/v1/gst/verify \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{\"gst_number\":\"10AABCY0494J1ZF\"}'
$.ajax({ url: "https://app.way2api.com/api/v1/gst/verify", type: "POST", contentType: "application/json", headers: { "Authorization": "Bearer YOUR_API_KEY" }, data: JSON.stringify({ "gst_number": "10AABCY0494J1ZF" }), success: function(data) { console.log(data); }, error: function(xhr) { console.error(xhr.responseJSON); } });
const { data } = await axios.post( "https://app.way2api.com/api/v1/gst/verify", {"gst_number":"10AABCY0494J1ZF"}, { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); console.log(data);
import requests response = requests.post( "https://app.way2api.com/api/v1/gst/verify", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, json={ "gst_number": "10AABCY0494J1ZF" } ) print(response.status_code) print(response.json())
Response Example
200 OK Success Response 
{
    "success": true,
    "message": "",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "result": {
            "gstin": "10AABCY0494J1ZF",
            "lgnm": "YOFLIC INDIA PRIVATE LIMITED",
            "tradeNam": "YOFLIC INDIA PRIVATE LIMITED",
            "sts": "Active",
            "dty": "Regular",
            "ctb": "Private Limited Company",
            "rgdt": "16/05/2019",
            "lstupdt": "13/07/2023",
            "stj": "Saran 1",
            "ctj": "CHHAPRA RANGE",
            "panNo": "AABCY0494J",
            "einvoiceStatus": "Yes",
            "nba": [
                "Office / Sale Office",
                "Recipient of Goods or Services",
                "Supplier of Services",
                "Retail Business"
            ],
            "pradr": {
                "addr": {
                    "bnm": "C/O RITA DEVI, VILL-JALALPUR",
                    "st": "PANCH-BISHUNPURI,BLOCK-JALALPUR",
                    "loc": "JALALPUR",
                    "dst": "Saran",
                    "stcd": "Bihar",
                    "pncd": "841412"
                },
                "ntr": "Office / Sale Office, Supplier of Services"
            }
        }
    }
}
4xx Error Response 
{
    "success": false,
    "message": "Invalid GSTIN / UID",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "error_code": "INVALID_GSTIN",
        "result": {
            "gst_number": "10AABCY0494J2ZFA"
        }
    }
}
Common Response Codes
Code Meaning
200 OK — Request successful
400 Bad Request — Missing or invalid parameters
401 Unauthorized — Invalid or missing API key
429 Too Many Requests — Rate limit exceeded
500 Server Error — Try again later
Ready to integrate?

Start with free trial API calls. No credit card required.

Get API Key — Free Browse All APIs
Way2API Way2API
Contact Way2API

Login