Smart API Zone

GST Verification API

Endpoint Version: 1.0.0 | Cost: ₹3.00 per call

Endpoint Route

POST https://api.rsprint.site/api/v1/gateway/gst-verify

Description

Validate Goods and Services Tax Identification Number (GSTIN) profile details.

Request Headers

Header Name	Value / Type	Description
Content-Type	`string`	application/json
X-API-Key	`string`	your_api_key

Request Parameters (JSON Body)

Parameter Name	Required Type	Constraint
gstin	`string`	15-character GSTIN format

Response Headers

Header	Sample Value
Content-Type	application/json; charset=utf-8
X-Execution-Time-Ms	45.82 ms

Error Codes mapping

Error Code	Description / Scenario
INVALID_GSTIN	The GSTIN entered is invalid.

Code Integration

cURL Request Shell

NodeJS Axios Integration

const axios = require('axios');

axios.post('https://api.rsprint.site/api/v1/gateway/gst-verify', {
    "gstin": "27AAACG1234F1Z5"
}, {
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'X-API-Secret': 'YOUR_API_SECRET'
  }
}).then(res => console.log(res.data));

Python Requests Integration

import requests

url = 'https://api.rsprint.site/api/v1/gateway/gst-verify'
headers = {
    'X-API-Key': 'YOUR_API_KEY',
    'X-API-Secret': 'YOUR_API_SECRET'
}
response = requests.post(url, json={"gstin":"27AAACG1234F1Z5"}, headers=headers)
print(response.json())

PHP cURL Integration

<?php

$url = 'https://api.rsprint.site/api/v1/gateway/gst-verify';
$headers = [
    'X-API-Key: YOUR_API_KEY',
    'X-API-Secret: YOUR_API_SECRET',
    'Content-Type: application/json'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"gstin":"27AAACG1234F1Z5"}');

$res = curl_exec($ch);
echo $res;

Sample Success Response

{
    "status": "success",
    "data": {
        "gstin": "27AAACG1234F1Z5",
        "legal_name": "API ZONE ENTERPRISES PRIVATE LIMITED",
        "trade_name": "API ZONE",
        "status": "Active",
        "taxpayer_type": "Regular"
    }
}

Sample Error Response

{
    "status": "error",
    "message": "Invalid GSTIN"
}