Skip to content
T
Tools.Town
Free Online Tools for Everyone

GST Calculator API

Calculate GST, add or remove tax with CGST/SGST/IGST breakdown.

Category: Calculators Endpoint: /v1/calculators/gst Method: GET Auth: API Key

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.

Authorization: Bearer YOUR_API_KEY
You can get your API key from your dashboard.

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

application/json
{
  "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