GST Calculator API
Calculate GST, add or remove tax with CGST/SGST/IGST breakdown.
Fast & Accurate
Get precise results instantly.
Easy Integration
Simple REST API with JSON response.
Developer Friendly
Clear docs and SDK examples.
Free to Start
1,000 free requests/month.
Endpoint
All requests should be made to the following endpoint:
GET https://api.tools.town/v1/calculators/gst Authentication
This endpoint requires an API Key. Include your API key in the request header.
Request Parameters
Send a GET request with query parameters.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
amount | number | ✓ | Amount must be greater than zero. | 500000 |
rate | number | ✓ | GST rate must be between 0 and 100. | 8.5 |
type | enum | ✓ | The type parameter. | add |
gstType | enum | ✓ | The gstType parameter. | intra |
Example Request
curl -G "https://api.tools.town/v1/calculators/gst" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "amount=500000" \
--data-urlencode "rate=8.5" \
--data-urlencode "type=add" \
--data-urlencode "gstType=intra" Example Response 200 OK
{
"success": true,
"data": {
"baseAmount": "0",
"gstAmount": "0",
"cgst": "0",
"sgst": "0",
"igst": "0",
"totalAmount": "0"
}
} Error Codes
| Code | Meaning |
|---|---|
| 400 | Bad Request — missing or invalid parameter |
| 401 | Unauthorized — API key missing or invalid |
| 429 | Rate limit exceeded — free tier: 1,000 requests/month |
| 500 | Internal Server Error — try again or contact support |