GSTIN Verification

Business Verification API

The GSTIN Verification API allows you to verify the GSTIN (Goods and Services Tax Identification Number) of a business entity. By providing a valid GSTIN, you can retrieve essential information about the business, including its legal name, trade name, registration details, and more. This API is useful for businesses, financial institutions, and government agencies to validate the authenticity of GSTINs and ensure compliance with tax regulations.

Request URL

POST

https://ekyc.nerotix.in/api/v1/service/gstin/verify

Authentication Required REQUIRED

Pass a valid Bearer Token in the Authorization header with every request.

Authorization: Bearer YOUR_BEARER_TOKEN

Parameters

Name	Type	Description
gstinNumber required	string	The GSTIN number of the business to be verified. It should be a valid 15-character alphanumeric GSTIN.

Request Body

application/json

{
    "gstinNumber": "23AAAAA1234J1ZW"
}

Response Examples

API Response

Sample responses returned by the GSTIN Verification API.

Successful Response

Success

GSTIN verification completed successfully

HTTP 200 OK

application/json

{
    "success": true,
    "statusCode": 1,
    "message": "GSTIN verification completed",
    "data": {
        "reference_id": 1578609,
        "GSTIN": "23BATPR5758J1ZW",
        "legal_name_of_business": "MANOJ RATHOR",
        "trade_name_of_business": "JYOTI TELECOM",
        "center_jurisdiction": "RANGE - BHIND",
        "state_jurisdiction": "Bhind",
        "date_of_registration": "2017-07-02",
        "constitution_of_business": "Sole Proprietorship",
        "taxpayer_type": "Regular",
        "gst_in_status": "Cancelled",
        "last_update_date": "2022-05-12",
        "cancellation_date": "2021-12-31",
        "nature_of_business_activities": [
            "Retail Business",
            "Supplier of Services",
            "Wholesale Business"
        ],
        "principal_place_address": "WARD NO. 4, GWALIOR ROAD, HOUSE NO. 166, BHIND, MEHGAON, Madhya Pradesh, 477557",
        "principal_place_split_address": {
            "building_name": "GWALIOR ROAD",
            "street": "MEHGAON",
            "location": "BHIND",
            "building_number": "HOUSE NO. 166",
            "district": "Bhind",
            "state": "Madhya Pradesh",
            "city": "",
            "flat_number": "WARD NO. 4",
            "latitude": "",
            "longitude": "",
            "pincode": "477557"
        },
        "gst_status": "GSTIN is Cancelled & Invalid"
    }
}

Invalid Response

Invalid

GSTIN is invalid

HTTP 200 OK

application/json

{
    "success": false,
    "statusCode": 0,
    "message": "Invalid GSTIN. Please check the number again."
}

Note Please keep the following points in mind while integrating this API.

The API endpoint should be accessed via a POST request.
Ensure that the request is properly validated and sanitized to prevent security vulnerabilities.
Implement proper error handling on the client side to display user-friendly error messages based on the 'statusCode' and 'message' fields in the response.
Always include a valid Bearer Token in the Authorization header when making API requests.